How to deploy Vike to AWS

Deploy a Vike-generated static site to S3 and CloudFront.

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

Configure the deployment

Ravion creates and manages the AWS resources in your account. This example uses Railpack for the build. Use build_source: dockerfile instead when you need a custom Dockerfile. Configure your Vike project for a static build, then use its generated output directory in ravion.yaml.

ravion.yaml

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

The Vike build command and output directory depend on the adapter and project configuration. Verify the generated directory is dist before applying. If your app uses a server adapter, use the ECS pattern instead of this static page.

Apply and connect your domain

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

Use custom domains to configure the CloudFront alias.

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