AWS Copilot uses AWS credentials to access the AWS API, store and look up an application's metadata, and deploy and operate an application's workloads.
You can learn more on how to configure AWS credentials in the AWS CLI's documentation.
We recommend using a named profile to store your application's credentials.
The most convenient way is having the
[default] profile point to your application's credentials:
AWS_PROFILE environment variable to point to a different named profile. For example, we can have a
[my-app] profile that can be used for your Copilot application instead of the
You cannot use the AWS account root user credentials for your application. Please first create an IAM user instead as described here.
credential_process = /opt/bin/awscreds-custom --username helen
# Then you can run your Copilot commands leveraging the alternative profile:
$ export AWS_PROFILE=my-app
$ copilot deploy
We do not recommend using the environment variables:
AWS_SESSION_TOKEN directly to look up your application's metadata because if they're overridden or expired, Copilot will not be able to look up your services or environments.
To learn more about all the supported
config file settings: Configuration and credential file settings.
Copilot environments can be created in AWS accounts and regions separate from your application's. While initializing an environment, Copilot will prompt you to enter temporary credentials or a named profile to create your environment:
$ copilot env init
Which credentials would you like to use to create prod-iad?
> Enter temporary credentials
> [profile default]
> [profile test]
> [profile prod-iad]
> [profile prod-pdx]