Deploy your app on Heroku

Step 1: Create a Heroku account

Go to the Heroku signup page and enter all the required details to create an account or just sign in if you already have an account.

Once you are signed in, you will see your empty application dashboard:

Empty Heroku dashboard

Step 2: Create your application

On your empty dashboard, click the "Create new app" button. You will then see a screen where you can enter your application name and choose a region where your app should be hosted. Enter your app name (as below) and choose the desired region for your application. Then click the "Create app" button to create your application.

Create new app on Heroku

Step 3: Connect your GitHub account to Heroku

Once you created your application, you will be navigated to the deployment page of your app. Choose the "Connect to GitHub" option and click the purple "Connect to GitHub" button at the bottom of the page.

Connect Heroku to GitHub

A GitHub authorization window will pop up asking you to approve the authorization request. After you connected your GitHub account to Heroku you'll be able to search for the repository that you want to deploy. Once you found the repository, click the "Connect" button next to it.

Search for GitHub repo on Heroku

Optional step: Enable automatic deployments

After you have connected your GitHub repository you have the option to enable automatic deployments for a specific branch. This is handy if, for instance, you want to automatically deploy any changes to your dev or staging environment. If you want to enable automatic deployments, select the branch for which you want to enable it and click the "Enable Automatic Deploys" button. Any new commit to the branch will automatically trigger a new deployment.

Enable automatic deployments in Heroku

Step 4: Add configuration variables for your app

Navigate to the settings tab of your Heroku application and click the "Reveal Config Vars" button.

Settings tab Heroku

You'll then be able to see all the configuration variables (if any) for your app. Add all the required configuration variables for this boilerplate here.

Heroku config variables

Step 5: Trigger your first deployment

Navigate back to the "Deploy" tab of your application and scroll to the "Manual deploy" section (at the bottom of the page). Choose the branch that you want to deploy and click the "Deploy Branch" button.

Deploy branch manually

Once the deployment has started you'll be able to see the build logs in the console window underneath. If the deployment has completed successfully you'll see a message stating that "your app was successfully deployed.". Click the "View" button to view your deployed application.

Successful Heroku deployment

That's all you need to host your application on Heroku. If you enabled automatic deployments, a new deployment will automatically be triggered for every commit to that specific branch. If you prefer to do manual deployments you can trigger a deployment as explained in Step 5.

Last updated:

Stay up to date

Sign up for the Ship SaaS newsletter to get notifiedabout the latest updates and blog posts

We care about the protection of your data. Read our Privacy Policy and Terms & Conditions.