Troubleshoot CDKToolkit stack issues

AWS Amplify requires your AWS account and region to be bootstrapped in order to deploy resources into your account. Amplify uses the AWS Cloud Development Kit (AWS CDK) to scaffold backend resource configurations and orchestrate deployments by using the supplemental resources created by the process of bootstrapping.

Bootstrapping is the process of preparing your AWS environment for usage with the AWS Cloud Development Kit (AWS CDK). Before you deploy a CDK stack into an AWS environment, the environment must first be bootstrapped.

Learn more about bootstrapping by visiting the AWS documentation for AWS CDK's concept of bootstrapping.

Error bootstrapping account

When deploying an Amplify app you may be redirected to the Amplify Console to complete bootstrapping for your current account ID and region. If this process encounters an error you will be prompted with the following message:

Amplify Console

Error bootstrapping account in region “<your-aws-region>”. There is an issue with the CDKToolkit stack which must be resolved manually.

This typically indicates one or more of the resources within the CDKToolkit stack has failed to create or update. Navigate to the AWS CloudFormation console, select your CDKToolkit stack, and select the "Events" tab to view resource events. Here you may identify issues with the corresponding assets bucket or issues with the IAM roles used for deployments.

You can mitigate by manually updating your CDKToolkit stack using the browser-based AWS CloudShell:

AWS CloudShell

cdk bootstrap aws://$(aws sts get-caller-identity --query Account --output text)/$AWS_REGION

Or by running bootstrap using the AWS CDK CLI from your terminal:

Terminal

npx aws-cdk@latest bootstrap aws://<your-aws-account-id>/<your-aws-region>

If you continue to experience this issue after applying the workaround noted above, please file an issue in the GitHub repository for Amplify Backend.

Stack CDKToolkit already exists

If you are deploying an Amplify app for the first time and have previously bootstrapped your AWS account to work with CDK, and you encounter the following error in the Amplify Console: