How to deploy RedwoodJS to AWS

Run RedwoodJS on ECS Fargate behind an Application Load Balancer with PostgreSQL on RDS.

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 RedwoodJS app for Ravion ECS hosting.

Configure the deployment

Ravion provisions the VPC, cluster, web service, and database in your AWS account. This example uses Railpack for the build. Use build_source: dockerfile instead when you need a custom Dockerfile. Build the Redwood API and web sides with yarn rw build. Redwood’s production server command depends on the generated deployment target; use the start command from your Redwood version’s deployment documentation.

ravion.yaml

project:
  givenId: redwood-app
  name: RedwoodJS app
environments:
  - givenId: production
    name: Production
    moduleInstances:
      - givenId: network
        name: Network
        type: rvn-aws-network
        version: 1.0.0
        input:
          aws_account_id: ravion-prod
          aws_region: us-east-1
          name: redwood-production
      - givenId: database
        name: PostgreSQL
        type: rvn-rds
        version: 1.0.0
        input:
          network:
            moduleGivenIdRef: network
          name: redwood-production
          db_name: redwood
          username: redwoodadmin
          engine_major_version: "15"
      - givenId: cluster
        name: ECS cluster
        type: rvn-ecs-cluster
        version: 1.0.0
        input:
          network:
            moduleGivenIdRef: network
          name: redwood-production
      - givenId: web
        name: Redwood web service
        type: rvn-ecs-web
        version: 1.0.0
        input:
          cluster:
            moduleGivenIdRef: cluster
          name: redwood-production-web
          build_source: railpack
          source_repo: my-org/my-redwood-app
          railpack_build_cmd: yarn rw build
          railpack_start_cmd: yarn rw serve
          container_port: 8910
          fargate_size:
            vcpu: 1
            memory_gb: 2

Provide the RDS connection as DATABASE_URL and Redwood’s required runtime settings through Secrets Manager. The module schema does not automatically wire RDS outputs into ECS secrets; create the secret from the database outputs before applying the service.

Apply and connect your domain

ravion project create --given-id redwood-app --name "RedwoodJS app"
ravion project config apply redwood-app --file ravion.yaml --dry-run
ravion project config apply redwood-app --file ravion.yaml

Configure the ALB hostname with custom domains.

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.

​Prerequisites

​Configure the deployment

​Apply and connect your domain

​Next steps