Setting up

Get started by installing the infraweave cli.

# Download the binary
curl -Lo infraweave https://github.com/infraweave-io/infraweave/releases/latest/download/cli-linux-amd64

# Make it executable
chmod +x infraweave

# Move it to a directory in your PATH, e.g.
mkdir -p ~/.local/bin
mv infraweave ~/.local/bin

# Optional: Add the following to ~/.bashrc or ~/.zshrc:
export PATH="$HOME/.local/bin:$PATH"

# Download the binary
curl -Lo infraweave https://github.com/infraweave-io/infraweave/releases/latest/download/cli-linux-arm64

# Make it executable
chmod +x infraweave

# Move it to a directory in your PATH, e.g.
mkdir -p ~/.local/bin
mv infraweave ~/.local/bin

# Optional: Add the following to ~/.bashrc or ~/.zshrc:
export PATH="$HOME/.local/bin:$PATH"

# Download the binary
curl -Lo infraweave https://github.com/infraweave-io/infraweave/releases/latest/download/cli-macos-arm64

# Make it executable
chmod +x infraweave

# Move it to a directory in your PATH, e.g.
mkdir -p ~/.local/bin
mv infraweave ~/.local/bin

# Optional: Add the following to ~/.bashrc or ~/.zshrc:
export PATH="$HOME/.local/bin:$PATH"

# Download the binary
curl -Lo infraweave https://github.com/infraweave-io/infraweave/releases/latest/download/cli-macos-amd64

# Make it executable
chmod +x infraweave

# Move it to a directory in your PATH, e.g.
mkdir -p ~/.local/bin
mv infraweave ~/.local/bin

# Optional: Add the following to ~/.bashrc or ~/.zshrc:
export PATH="$HOME/.local/bin:$PATH"

iwr https://github.com/infraweave-io/infraweave/releases/latest/download/cli-windows-amd64.exe -OutFile "$Env:USERPROFILE\bin\infraweave.exe"; Unblock-File "$Env:USERPROFILE\bin\infraweave.exe"

Now it’s installed! Please remember to keep it up to date.

It is also possible to run the cli using docker. The following will ensure it has access to AWS when running:

# Put the following in your rc-file (~/.bashrc, ~/.zshrc or similar)
alias infraweave='docker run -it --rm -v "$(pwd)":/app -v "$HOME/.aws":/root/.aws --env-file <(env | GREP ^AWS_) infraweave/cli:latest cli'

Verify installation

To verify the installation, run the following command:

infraweave --version

Running commands

Before you run any infraweave commands, make sure your cloud credentials and default region are set—just like you would for aws or az. Otherwise, the CLI will fail when it tries to call the API.

For example, to configure AWS:

export AWS_REGION=us-west-2
export AWS_PROFILE=central

Once your cloud is bootstrapped and these environment variables are in place, you’ll be ready to go.

Bootstrap Environment

To bootstrap your environment, set up the central and workload modules for your desired cloud provider, find them here.

You need to set up:

central - storage and databases required by the control plane
workload - runtime environments which should be deployed per project (e.g. AWS Account/Azure Subscription)

Start using 🎉

Now you have bootstrapped your AWS organization accounts with InfraWeave and are ready to use it.

Ensure you have set a region and a profile to use, as well as which InfraWeave environment you want to connect to:

export AWS_REGION=us-west-2
export AWS_PROFILE=central

If you run

infraweave module list beta

you will list all your modules that have been published to the beta-track in your central account for the dev-environment.

It is expected to show an empty list since you have not yet published anything:

$ infraweave module list beta
Project ID: 123456789101
Region: us-west-2
Module               ModuleName           Version              Track           Ref