How to deploy Gatsby to AWS

Deploy Gatsby’s generated public directory to S3 and serve it through CloudFront in your AWS account.

Prerequisites

A Git repository containing your application and its production build command.
A Ravion account with your AWS account connected. Start free at Ravion signup.
The Ravion CLI installed and authenticated. See CLI installation.

The examples use my-org/my-app as a placeholder. Replace it with your repository before applying the config.

Set up this Gatsby app for Ravion static hosting.

Open in Cursor

Configure the deployment

This example uses Railpack for the build. Use build_source: dockerfile instead when you need a custom Dockerfile.

ravion.yaml

project:
  givenId: gatsby-site
  name: Gatsby site
environments:
  - givenId: production
    name: Production
    moduleInstances:
      - givenId: static-site
        name: Gatsby site
        type: rvn-aws-static
        version: 1.0.0
        input:
          aws_account_id: ravion-prod
          aws_region: us-east-1
          name: gatsby-site-production
          routing: filesystem
          build_source: railpack
          source_repo: my-org/my-gatsby-site
          output_directory: public
          railpack_build_cmd: npm run build

Gatsby runs npm run build and writes the production files to public. Add public build-time values to build_environment_variables.

Apply and connect your domain

ravion project create --given-id gatsby-site --name "Gatsby site"
ravion project config apply gatsby-site --file ravion.yaml --dry-run
ravion project config apply gatsby-site --file ravion.yaml

Complete custom domains to configure DNS and TLS.

Next steps

Custom domains

Point a domain at your deployed service and manage its certificate.

Project config

Preview and apply Ravion configuration from source control.

Pipelines

Add approvals, migrations, and deployment automation.

Logs and metrics

Inspect deploy output and production health in Ravion.

⌘I

​Prerequisites

​Configure the deployment

​Apply and connect your domain

​Next steps