How to Install Tronador CLI

tronador-cli is the Cloud Ops Works package and repository for the Tronador command-line workflow tools. The released executable is tronador. This guide reflects v0.5.10, the latest stable GitHub release as of October 20, 2026. For complete usage and configuration, see the Tronador CLI documentation.

What you get

• Repository template lifecycle commands under tronador repos.
• Template detection, compatible tag discovery, upgrade, recovery, migration, CICD metadata, and push helpers.
• AWS resource automation for organization metadata, S3/EC2 remediation, default VPC removal, and related operations.
• Release artifacts from the GoReleaser pipeline: GitHub archives, Linux packages, Homebrew, shell and PowerShell installers, and a Chocolatey package asset. Chocolatey community-feed publication follows the GitHub release separately.

Prerequisites

For installed binaries:

• AWS credentials with the permissions required by the tronador aws ... command you plan to run.
• GitHub authentication through GH_TOKEN, GITHUB_TOKEN, or gh auth login when running tronador repos commands that query GitHub or set repository defaults.

Quick install matrix

Linux and macOS shell installer

Supported targets are macOS amd64 / arm64 and Linux amd64 / arm64.

Install the latest stable release:

curl -fsSL https://raw.githubusercontent.com/cloudopsworks/tronador-cli/master/scripts/install.sh | sh

Install an explicit version. Explicit versions can point to prereleases:

curl -fsSL https://raw.githubusercontent.com/cloudopsworks/tronador-cli/master/scripts/install.sh | sh -s -- --version v0.5.10

Useful installer options:

scripts/install.sh --install-dir "$HOME/.local/bin"
scripts/install.sh --repo cloudopsworks/tronador-cli --version v0.5.10 --dry-run

Upgrade by rerunning the installer with no version for the latest stable release, or with a new explicit version.

Uninstall a shell install by removing the installed binary:

rm -f /usr/local/bin/tronador
# or, if installed for the current user:
rm -f "$HOME/.local/bin/tronador"

Windows PowerShell installer

Install the latest stable release:

iwr https://raw.githubusercontent.com/cloudopsworks/tronador-cli/master/scripts/install.ps1 -UseB | iex

Install an explicit version:

& .\scripts\install.ps1 -Version v0.5.10

Validate URL resolution without downloading artifacts:

& .\scripts\install.ps1 -Version v0.5.10 -Architecture amd64 -DryRun

By default, the installer writes to:

%LOCALAPPDATA%\Programs\tronador-cli\bin

It also adds that directory to the user PATH unless -NoPathUpdate is provided. Upgrade by rerunning the installer. Uninstall by deleting tronador.exe from the install directory and removing the directory from the user PATH if it is no longer needed.

Native Linux packages

GoReleaser generates DEB, RPM, and APK packages from the same release binaries. Download the package matching your version and architecture from the GitHub Release assets, then install it locally.

# Debian / Ubuntu
sudo apt install ./tronador-cli_<version>_<arch>.deb

# RHEL / Fedora / CentOS
sudo dnf install ./tronador-cli-<version>-1.<arch>.rpm
# or:
sudo rpm -i ./tronador-cli-<version>-1.<arch>.rpm

# Alpine Linux
sudo apk add --allow-untrusted ./tronador-cli_<version>_<arch>.apk

The packages install the tronador executable into /usr/bin and include README/license documentation under /usr/share/doc/tronador-cli/.

Upgrade by installing a newer package from a later release. Uninstall with the platform package manager:

sudo apt remove tronador-cli
sudo dnf remove tronador-cli
sudo apk del tronador-cli

Homebrew

brew install cloudopsworks/tap/tronador-cli

Homebrew handles upgrades and uninstall:

brew update && brew upgrade tronador-cli
brew uninstall tronador-cli

Chocolatey (Windows)

Install, upgrade, or uninstall the tronador-cli package with Chocolatey. The installed command is tronador:

choco install tronador-cli
choco upgrade tronador-cli
choco uninstall tronador-cli

Chocolatey installs the latest approved version in its community feed, which can lag GitHub releases. As checked on October 20, 2026, the community package page listed v0.5.9 while GitHub had published v0.5.10. For v0.5.10 now, use the PowerShell installer or a Windows asset from the v0.5.10 GitHub release. The upstream installation documentation has current platform guidance.

Verify the install

tronador version
tronador --help
tronador repos --help

A useful first repository command is version discovery for a local project:

tronador repos available --workdir ../my-service

Then run an upgrade workflow with either the latest compatible tag in the current major/minor line or an explicit tag:

# Latest compatible upgrade workflow
tronador repos upgrade --workdir ../my-service

# Explicit tag or branch
tronador repos upgrade v5.10.76 --workdir ../my-service

Release-selection policy

• Install scripts default to the GitHub latest release endpoint, which resolves stable releases.
• Prerelease installation is allowed only when you explicitly pass a version/tag.
• Homebrew, Chocolatey, and native Linux package metadata is generated by GoReleaser; Chocolatey feed publication and approval may happen later than the GitHub Release.

For the latest changes, read what changed from v0.5.5 to v0.5.10 or browse the Tronador CLI documentation.