← Back to Guides
Header image for guide: Deploying Gatsby on Northflank
Profile image for Maria Alonso

By Maria Alonso

Published 1st February 2022

Deploying Gatsby on Northflank

Gatsby is an open-source framework that combines functionality from React, GraphQL and Webpack into a single tool for building static websites and apps. At build time Gatsby fetches all of the data, renders the entire website into HTML files with the data that is there, and it is ready to be deployed super fast.

This guide will show you how to deploy a Gatsby application on Northflank.

As source of your deployment, you have two options: either using a Gatsby project you have created and have in version control or the template we provide.

Deploy a Gatsby repository from your version control

  1. Connect your Git provider to your Northflank account. You can find more details on how to do so here.

  2. Once your Git provider is connected, create a new combined service. Under Repository, you will see a list of your repositories from which you can choose your Gatsby project repo. Select the branch you would like to deploy initially, this can always be changed later.

    • A combined service handles build and deployment of your code.

  3. Under Build Options, if you have a Dockerfile configured for your project you can choose Dockerfile or if this is not the case, you can choose Buildpack.

  4. Access the deployment via the unique code.run service URL or finish up by linking a custom domain.

Deploy from a Northflank Gatsby template

This deployment method will use the public repository we have created as a template of Gatsby and is the fastest way to get a Gatsby project bootstrapped and deployed.

  1. Create a new service and select the option to pick from one of our existing templates. Select the Gatsby template.

  2. Once the template is selected, you can choose a service name and select the VCS where a new repository will be created with the template.

  3. Access the deployment via the unique code.run service URL or finish up by linking a custom domain. You will see the Gatsby welcome page and the application is ready for you to build great things on top of it!

Using Northflank to deploy your Gatsby project

Northflank allows you to deploy your code and databases within minutes. Sign up for a Northflank account and create a free project to get started.

  • Connect with your preferred VCS: GitHub, GitLab or Bitbucket
  • Manage build arguments and environment variables using secret groups
  • Scale vertically and horizontally with multiple replicas per service
  • Observe & monitor with real-time metrics & logs
  • Create pipelines and release workflow as you grow

Share this article with your network