Skip to main content

Install on AWS

This guide will perform a complete production-ready installation in your AWS environment using AWS CDK.

The resulting AWS configuration should look like the following:

Medplum AWS Architecture


You will need permission to access the following AWS services:

  1. ECR
  2. ECS
  3. RDS
  4. S3
  5. CloudFront

You will need the ARN for ACM Certificates for the following hosts:

  1. App (i.e.,
  2. API (i.e.,
  3. Storage (i.e.,

While CDK can provision certificates, we do not recommend doing so.


Create a Medplum CDK config file.


Run CDK synth:

npx cdk synth


Run CDK deploy:

npx cdk deploy