Self-managed hosting

Self-managed hosting gives you full ownership of your frontend infrastructure. You deploy to your own AWS account using AWS CDK constructs, giving you complete control over Amazon S3 buckets, Amazon CloudFront distributions, Lambda@Edge functions, and every other resource in your stack.

How it works

You define your hosting configuration in amplify/hosting.ts using defineHosting(). This generates an AWS CDK stack with all the resources needed to serve your application. You deploy with the ampx deploy CLI command, which synthesizes and deploys both backend and frontend stacks to your AWS account.

amplify/hosting.ts
import { defineHosting } from '@aws-amplify/hosting';
export const hosting = defineHosting();

Deployment options

You have three ways to deploy self-hosted applications:

Manual deployment with ampx deploy runs directly from your local machine or any environment with AWS credentials.

Built-in pipeline with definePipeline() provisions a self-mutating AWS CodePipeline V2 that deploys on every push to your repository.

External CI/CD using GitHub Actions, GitLab CI, or any CI runner that can execute ampx deploy with the appropriate flags.

When to use self-managed hosting

Self-managed hosting is the right choice when you need direct access to your infrastructure resources, want to customize CDN behavior, require AWS WAF protection, or need to integrate hosting into an existing AWS organization with specific compliance requirements.

Getting started with self-hosting

Install the hosting package and deploy your first app.

Supported frameworks

Frameworks supported by self-managed hosting and their feature capabilities.

Configure hosting

Customize your hosting infrastructure with domains, AWS WAF, compute settings, and AWS CDK escape hatches.

Secrets and environment variables

Inject non-sensitive environment variables, and reference secrets and configuration without baking values into your infrastructure.

Set up a CI/CD pipeline

Automate deployments with a self-mutating AWS CodePipeline.

Use an external CI/CD pipeline

Deploy with GitHub Actions, GitLab CI, or any CI runner.