Getting started with Oxygen
Oxygen is a hosting platform that enables you to deploy and preview your Hydrogen storefront without configuring or maintaining infrastructure.
In this tutorial, you'll learn how to add the Hydrogen channel to a Shopify store, so that you can start deploying to Oxygen.
Requirements
Anchor link to section titled "Requirements"- You have the staff role on the Shopify store that you're working with.
- You have Apps and channels permissions on the Shopify store that you're working with.
- The Shopify store that you're working with isn't a development store.
Step 1: Add the Hydrogen channel
Anchor link to section titled "Step 1: Add the Hydrogen channel"The Hydrogen channel enables the store that you're working on to use Oxygen for managing Hydrogen storefronts.
The Hydrogen channel doesn't replace or change the online store channel of the store that you're working on, or your live storefront.
You can install the Hydrogen channel with the following procedure, or you can install it from the Shopify App Store.
From your Shopify admin, beside Sales channels, click >.
Click All recommended sales channels.
Click Hydrogen.
Click Add.
Step 2: Install the Shopify GitHub app
Anchor link to section titled "Step 2: Install the Shopify GitHub app"The Shopify GitHub app enables you to connect a GitHub account to your Shopify admin. This connection enables you to make and track changes to Hydrogen storefront code, and enables you to collaborate with other developers to share progress.
Select the GitHub account that will use the Hydrogen storefront GitHub repository.
If the GitHub account that you want to use isn't in the list, then click Add account to add the GitHub account.
If you're prompted to authorize and install the Shopify GitHub app, then accept the prompt.
Select whether you want to install the app on your personal account or in an organization.
If the repository belongs to an organization where you don't have rights to install an app, then you might need to request that your administrator approve the installation before proceeding.
Troubleshooting your GitHub connection
Anchor link to section titled "Troubleshooting your GitHub connection"In rare circumstances, when you have SSO enabled on your organization, the connection to your GitHub account might fail but show a successful connection. To rebuild the connection, you can revoke the Shopify GitHub app's access to your account through your GitHub settings, and then ensure that you're logged in and have an active SAML session before completing the setup process again.
You can create a SAML session by visiting https://github.com/orgs/ORGANIZATION-NAME/sso
in your browser. Replace ORGANIZATION-NAME
with the name of your organization.
For more information about SAML authentication, refer to the GitHub documentation.
- Learn how to manage storefronts using the Hydrogen channel.
- Learn how to connect a Hydrogen storefront to a new or existing Hydrogen Git repository.