Skip to content

Lambda Cloud

The Lambda backend allows provisioning infrastructure in Lambda Cloud while storing artifacts in an S3 bucket.

Follow the step-by-step guide below to configure this backend in your project.

Set up storage

As Lambda Cloud doesn't have its own object storage, dstack requires you to specify an S3 bucket, along with AWS credentials, for storing state and artifacts.

Create an S3 bucket

First, you need to create an S3 bucket. dstack will use this bucket to store state and artifacts.

Create an IAM user

The next step is to create an IAM user and grant this user permissions to perform actions on the s3 service.

Logs and secrets

If you want dstack to also store logs and secrets, you can optionally grant permissions to the logs and secretsmanager services.

Create an access key

To create an access key, follow this guide. Once the access key is created, make sure to download the .csv file containing your IAM user's Access key ID and Secret access key.

Set up API key

Then, you'll need a Lambda Cloud API key. Log into your Lambda Cloud account, click API keys in the sidebar, and then click the Generate API key button to create a new API key.

Configure the backend

Now, log in to the UI, open the project's settings, click Edit, then click Add backend, and select Lambda in the Type field.

Fields reference

The following fields are required:

  • API key - (Required) The [API key] to authenticate dstack with Lambda Cloud
  • Regions - (Required) The list of regions where dstack may provision infrastructure. It is recommended to select as many regions as possible to maximize availability.
  • Storage - (Required) The storage provider that dstack will use to store the state and artifacts. Currently, only AWS is supported.
  • Access key ID - (Required) The Access key ID to authenticate dstack with AWS
  • Secret access key - (Required) The Secret access key to authenticate dstack with AWS
  • Bucket - (Required) The S3 bucket to store state and artifacts