@aws is a vendor-specific space for declaring your AWS region & profile


  • Accepts values for either or both of two keys:
    • region: AWS region ID of the region you'll deploy this project to
    • profile: name of the profile you prefer to use with this project, as defined in your local AWS profile
    • runtime: lambda runtime, it can be either nodejs8.10 or provided if you want to use a Custom Runtime with AWS Lambda Layers (_check note below_)

For more on working with AWS, please see: Multiple AWS Accounts.

Alternatively, if you want a less granular approach, you can declare your preferred region and profile in your .bashrc (more information here).

If you have AWS exports in your .bashrc and @aws specified in your .arc project, the @aws section will win.


For example, to deploy to the northern California AWS AZ with your AWS work profile's credentials, use:

region us-west-1
profile work

Custom Runtimes with AWS Lambda Layers

If you want to use a custom runtime with Lambda Layers you need to set runtime to provided and set the following key:

For example, to deploy to Oregon AWS AZ with your AWS default profile's credentials and using a custom Node.js 10 runtime, use:

region us-west-2
profile default
runtime provided
layer arn:aws:lambda:us-west-2:800406105498:layer:nsolid-node-10:6

Next: Setup DNS with @domain