steer docs
documentation

steer docs

Getting started

Install steer, connect it to your AWS account and ship your first deploy.

Install

macOS — Homebrew (recommended)

brew install juanMaAV92/tap/steer

# update later
brew update && brew upgrade steer

No Gatekeeper prompts: the cask clears the quarantine flag on install.

Linux (and any OS with Go installed)

# install AND update — same command, always fetches the latest release
go install github.com/juanMaAV92/steer/cmd/steer@latest

Without Go: download steer_*_linux_{amd64,arm64}.tar.gz from the latest release and place steer on your PATH.

Windows

Download steer_*_windows_amd64.zip from the latest release, unzip and add steer.exe to your PATH. Use Windows Terminal — the TUI (mouse included) degrades in the legacy cmd.exe console.

Check your install anytime:

steer --version

Connect your cloud

Run the interactive wizard — this is the one-time step for whoever knows the cloud:

steer config init

The wizard reads the AWS profiles you already have in ~/.aws, lists your real clusters to pick from, runs a connection smoke test and writes steer.toml for you. Add more accounts or environments later with steer config add.

Prefer a file? steer config init --example writes a commented starter steer.toml you can edit by hand. Details in Configuration.

Open the dashboard

steer tui
steer — tui
⛵ steer · aws · staging (cluster: staging-cluster)          writable ●

SERVICES        (3)
● api      2/2  v1.4
● web      3/3  v2.0
◐ worker   1/2  v1.1

IMAGES          (3)
▸ api
▸ web
▸ workerDetails Events Logs
running   2/2
status    ACTIVE
tag       v1.4


[d] deploy  [s] scale  [z] resize  [R] rollback
↑↓ select · d deploy · / filter · c context · q quit

Pick a service, hit a button (or d / s / z / R), confirm in the inline form and watch the rollout stream live into the Events tab. Full tour in the TUI guide.

Ship your first deploy

From the TUI: select the service, press d, pick a tag from the picker (it reads your registry), confirm. Or script it:

# interactive: no flags → a fuzzy picker opens for service and tag
steer service deploy

# explicit + CI-friendly
steer --context stg service deploy -s api -t v1.2.3 --watch

Every deploy shows a preview (current tag → new tag) and asks before applying. Rollback is one command: steer service rollback -s api. The full flow, including how deploys are validated against your registry, is in Deploys.

Next steps