Deploy a Gatsby Static Site

You can deploy a Gatsby static site on Render in under a minute. Your site is served over a lightning-fast global CDN, comes with fully managed SSL certificates from Let’s Encrypt, and supports custom domains out of the box. Best of all, it’s free!

The sample app in this guide is based on Gatsby’s official default starter.

  1. Use your existing Gatsby repository, or fork our sample Gatsby repo on GitHub or GitLab.
  2. Create a new Web Service on Render, and give Render permission to access your new repo.
  3. Use the following values during creation:

    EnvironmentStatic Site
    Build Commandgatsby build
    Publish Directorypublic

That’s it! Your app will be live on your Render URL as soon as the build finishes.

A note on Node versions

By default, Render uses the latest LTS version of Node. But you can customize the version used for your app in one of two ways:

  • Add a file called .node-version at the root of your repo. This file should contain a single line containing the full semantic Node version you’d like to use.

    Your .node-version should look like this:

  • Alternatively, you can specify a Node version in the engines directive in your package.json. This can be an exact version like 10.17.0 or a range like >=10.11 <10.18.

    This is the relevant snippet from a sample package.json:

      "engines": {
        "node": ">=12 <13"