sailfork / t3code-github / .repos/ alchemy-effect/ website/ src/ content/ docs/ cli/ aws.mdx

import Terminal from "../../../components/Terminal.astro";
alchemy provider aws <subcommand> [options]

Cloud-provider commands for AWS — managing the per-account infrastructure that Alchemy itself relies on.

provider aws bootstrap

alchemy provider aws bootstrap [options]

Set up the AWS assets bucket required for deploying Lambda functions and other AWS resources that need artifact storage.

<Terminal content={[g]✓[/g] Created assets bucket: alchemy-assets-123456789012-us-west-2-an} />

Re-running is a no-op:

<Terminal content={[g]✓[/g] Assets bucket already exists: alchemy-assets-123456789012-us-west-2-an} />

OptionDescription
--aws-profile <name>AWS CLI/SSO profile to use for credentials (default: default)
--region <region>AWS region to bootstrap. Defaults to the AWS CLI profile's region, then us-east-1.
--env-file <path>Load environment variables from a file

Bootstrap requires an AWS CLI profile that is either SSO (sso_account_id) or console login (login_session from aws login). It fails with a clear error if the profile is neither.

Logs are written to the run log under ~/.alchemy/logs (see Log output).

provider aws teardown

alchemy provider aws teardown [options]

Removes every bootstrap bucket in the selected region and reports the count. It accepts the same profile, region, and environment-file options as bootstrap, plus --yes to skip confirmation.

<Terminal content={[g]✓[/g] Destroyed 1 bootstrap bucket(s): alchemy-assets-123456789012-us-west-2-an} />

If there's nothing to remove:

<Terminal content={[g]✓[/g] No bootstrap buckets found to destroy} />

# Bootstrap with the default profile
alchemy provider aws bootstrap

# Bootstrap a specific region and profile
alchemy provider aws bootstrap --aws-profile prod --region us-west-2

# Remove bootstrap resources
alchemy provider aws teardown

Where next

  • cloudflare — provider commands for Cloudflare
  • AWS — the AWS provider hub