Deploy your app to Heroku

• You've created an app using Shopify CLI, or you've migrated your app to work with Shopify CLI.

• You have a Heroku account and can create apps on it.

Create or link your app to an app.toml file. We recommend that developers have one configuration for development, and a separate one for production. That way, you can continue to develop your app after deploying it, without affecting your production environment.

1. Either create a new configuration, or use an existing one:

2. Get the necessary environment variables to deploy your app:

3. Note down the SHOPIFY_API_KEY, SHOPIFY_API_SECRET, and SCOPES values. You'll need to set them as environment variables before you can run your deployed app.

Create a new Heroku app using the Heroku CLI.

1. Download and install the Heroku CLI.

2. Log in to the Heroku CLI:

3. Log in to the Heroku Container Registry:

4. Create an app in Heroku:

   This command configures Heroku with a container-based app and creates a Git remote branch named heroku for deploying the app. It also returns the URL where the app will run when it's deployed.

To deploy the app, you'll need to add a Heroku configuration file to tell Heroku how to build the app.

1. At the top-level directory of your app's source code, create a heroku.yml file with the following content:

2. Commit the heroku.yml file to your Git repository:

Configure your Heroku app to run your app code and communicate with Shopify.

Create a container running your preferred database, then make sure your Prisma schema file points to it. For databases such as PostgreSQL or MySQL, you can use the DATABASE_URL environment variable in your schema to point to your container in different environments.

Refer to these important considerations for setting up your database.

You'll need to set the following environment variables for your app:

1. In a terminal, add the environment variables for your app using the heroku config:set command. You'll need your app's URL, so visit your Heroku dashboard and copy your app's URL.

2. With the URL, and the values from the shopify app env show command you ran before, run this command:

Before running the app on your hosting provider, you'll need to update your Shopify settings by deploying your TOML file using Shopify CLI.

1. In the shopify.app.*.toml file for your deployment environment, set application_url to the same as the SHOPIFY_APP_URL environment variable:

2. Deploy your configuration to apply the changes to Shopify:

Your app is ready to deploy now. You can do that following these steps:

1. Push the app to Heroku. It will automatically build the docker image and deploy the app whenever you push to the heroku remote:

2. Visit your Heroku dashboard, and check your logs to verify that the app started as expected.

After you update your app URLs in the Partner Dashboard, you can test your app in a development store to make sure that it's configured correctly.

1. In the Partner Dashboard, go to your app's Overview page.
2. In the Test your app section, click Select store and choose a store to test the app.

As you continue developing your app, you can re-deploy it with the following steps:

1. Select your production app with Shopify CLI:

2. Deploy your app configuration and extensions, if you made any changes:

3. Trigger a new deploy in Heroku: