Skip to main content

atmos terraform providers mirror

Use this command to save local copies of all required provider plugins for an Atmos component in a stack.

atmos terraform providers mirror --help

Usage

Execute the terraform providers mirror command like this:

atmos terraform providers mirror <component> -s <stack> <target-dir> [options]

This command downloads the providers required for the component and saves them to a local directory. This is useful for creating a local mirror for air-gapped environments or reducing external network dependencies.

tip

Run atmos terraform providers mirror --help to see all the available options

Examples

# Mirror providers to a local directory
atmos terraform providers mirror vpc -s dev /path/to/mirror

# Mirror for specific platforms
atmos terraform providers mirror vpc -s dev /path/to/mirror -platform=linux_amd64 -platform=darwin_amd64

Arguments

component (required)

Atmos terraform component.

target-dir (required)

The target directory where provider plugins will be saved.

Flags

--stack (alias -s) (required)

Atmos stack.

--dry-run (optional)

Show what would be executed without actually running the command.

atmos terraform providers mirror vpc -s dev /path/to/mirror --dry-run
--skip-init (optional)

Skip running terraform init before executing the command.

atmos terraform providers mirror vpc -s dev /path/to/mirror --skip-init

Native Terraform Flags

The atmos terraform providers mirror command supports native terraform providers mirror flags. Pass them directly or use -- to separate Atmos flags from Terraform flags.

-platform=OS_ARCH

Target platform for provider packages. Can be specified multiple times to mirror for multiple platforms.

atmos terraform providers mirror vpc -s dev /path/to/mirror -platform=linux_amd64 -platform=darwin_amd64

See Also