Skip to main content

AWS App Runner 🏃

App Runner is a fully managed service that makes it easy for developers to quickly deploy containerized web applications and APIs, at scale and with no prior infrastructure experience required. It is service in Amazon Web Services. App Runner automatically:

  • Load balances traffic with encryption
  • Scales to meet your traffic needs
  • Makes it easy for your services to communicate with other AWS services and applications that run in a private Amazon VPC


Before you get started, if you haven't already completed these steps, you'll have to:

  1. Create a free Amazon Web Services account

While Amazon Web Services has a free tier that should cover testing projects, you can incur costs when running this quickstart through App Runner or Elastic Container Registry. For more details, see AWS App Runner Pricing and Amazon Elastic Container Registry Pricing.

  1. Install Docker on your machine, and you'll have to start the app. You can verify it is set up correctly by running:
docker images

(If Docker is running, the command will print the images on your machine. If not, it will print something like Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?)

  1. Install the AWS CLI on your machine.

  2. Configure the AWS CLI to give it permission to push images. Just make sure the user you configure has the AmazonEC2ContainerRegistryFullAccess policy applied.

  3. Give Docker permission to push images to AWS by running:

aws ecr get-login-password --region [REGION] | docker login --username AWS --password-stdin [AWS_ACCOUNT_ID].dkr.ecr.[REGION]
  • [REGION]: The region you want to deploy to (ex: us-west-1)
  • [AWS_ACCOUNT_ID]: The id of the account you're deploying to, without dashes (can be found in the top right menu)
  1. Create a private Elastic Container Registry (ECR) Repository. This can be done in the AWS Console, or by running:
aws ecr create-repository --repository-name [REPOSITORY_NAME]
  • [REPOSITORY_NAME]: A name for the newly created repository.


1. Build your API for production use

Simply run:

dart_frog build

This will create a /build directory with all the files needed to deploy your API.

2. Build your API using Docker

In order to build a Docker image, you can run this command:

docker build build \
  • [REGION]: The region you want to deploy to (ex: us-west-1)
  • [AWS_ACCOUNT_ID]: The id of the account you're deploying to, without dashes (can be found in the top right menu)
  • [REPOSITORY_NAME]: The name of the repository you created earlier
  • [IMAGE_TAG]: A name given to this image to identify it in the repository

It will build the Docker image on your computer, this can take a few seconds to a few minutes.

3. Push the image to ECR

Now that you have the image on your computer, you can push it to ECR:


You should now see your repository in the ECR console

4. Create your App Runner Service

Follow these instructions. Look for the Create a service from an Amazon ECR image section.

5. Enjoy your API on AWS!

Congratulations 🎉, you have successfully built and deployed your API to App Runner. You can now access your API at the Default domain on the App Runner console

Additional Resources