How to deploy Docusaurus to AWS

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 Docusaurus app for Ravion static hosting.

Open in Cursor

Configure the deployment

Ravion provisions the resources in your AWS account.

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

ravion.yaml

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

Docusaurus uses npm run build and writes the production site to build. Put public build-time settings in build_environment_variables.

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

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

How to deploy Docusaurus to AWS

Prerequisites

Configure the deployment

Apply and connect your domain

Next steps

Custom domains

Project config

Pipelines

Logs and metrics

​Prerequisites

​Configure the deployment

​Apply and connect your domain

​Next steps

Custom domains

Project config

Pipelines

Logs and metrics

Prerequisites

Configure the deployment

Apply and connect your domain

Next steps