# Install terramate with Homebrew, Nix, winget

Managing Terraform stacks with change detections and code generations. Version 0.17.1 via Homebrew; verified 2026-05-26.

## Install

```sh
sudo av install brew:terramate
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install terramate
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#terramate
```

  Evidence: nixpkgs package indexes: pkgs/by-name/te/terramate/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- winget (92%):

```sh
winget install --id Terramate.CLI -e
```

  Evidence: Windows Package Manager source index: Terramate.CLI from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:terramate
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/terramate>
- **Version:** 0.17.1
- **Source summary:** Managing Terraform stacks with change detections and code generations
- **Homepage:** <https://terramate.io/docs/>
- **Repository:** <https://github.com/terramate-io/terramate>
- **Upstream docs:** <https://terramate.io/docs>
- **License:** MPL-2.0
- **Source archive:** <https://github.com/terramate-io/terramate/archive/refs/tags/v0.17.1.tar.gz>
- **Last updated:** 2026-05-26T16:51:44Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- terramate-ls (cli)
- terramate-ls (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.17.1
- Package-manager updated: 2026-05-26
- Local data: ok
- Upstream repository: https://github.com/terramate-io/terramate
- Upstream latest detected: v0.17.1 (current)
## Project history and usage

Terramate is an open-source Infrastructure as Code orchestration and code-generation CLI for Terraform, OpenTofu, Terragrunt, Kubernetes, and CI/CD workflows.

### Project history

The public Terramate repository was created in September 2021. Its README describes Terramate CLI as an open-source orchestration and code generation engine for scaling IaC, with optional pairing to Terramate Cloud for managed observability, drift detection, asset management, policy, and notification features.

Terramate's project model is built around stacks. The README emphasizes breaking large infrastructure into smaller stacks, reducing duplicated configuration through generated HCL, JSON, or YAML, and orchestrating commands across stacks with a graph-based engine.

The official CLI docs describe Terramate as a daily IaC workload tool for managing stacks, maintaining a DRY codebase with code generation, planning and deploying with orchestration and change detection, and synchronizing data with Terramate Cloud.

### Adoption history

Terramate is newer than Terragrunt but has become a visible Terraform/OpenTofu orchestration package. Repository metadata showed several thousand stars by July 2026, and input package metadata lists Homebrew, Nix, and winget packages.

The README's onboarding claims are aimed at incremental adoption: existing Terraform, OpenTofu, or Terragrunt projects can start with a single command and without refactoring, while teams can adopt features individually to avoid hard lock-in.

### How it is used

Common CLI usage includes creating and listing stacks, running commands such as terraform init or terraform apply across all or changed stacks, generating repeated backend and provider configuration, and filtering execution by Git changes, tags, directories, or Terramate Cloud status.

The official change-detection docs explain the --changed workflow for running commands only in stacks affected by a commit, branch, or pull request. The code-generation docs describe generating stack files from blueprints to keep Terraform backend and provider configuration DRY.

### Why package nerds care

For package-manager users, Terramate is significant because it packages a higher-level IaC workflow engine as a single CLI. It is useful in dev shells and CI images where users already install Terraform, OpenTofu, or Terragrunt and want change detection, orchestration, and generated configuration without adopting a hosted CI product.

Its cross-platform package metadata, Go-based install path, and optional Cloud pairing make it both a local CLI package and an entry point into a larger IaC platform.

### Timeline

- 2021: Public Terramate repository created.
- 2020s: CLI docs establish stack management, code generation, orchestration, and change detection as core workflows.
- 2026: Homebrew, Nix, and winget metadata list Terramate CLI packages.

### Related projects

- Terraform and OpenTofu are primary IaC engines Terramate orchestrates.
- Terragrunt is explicitly supported as an existing project style that Terramate can onboard.
- Terramate Cloud is the optional managed service paired with the open-source CLI.

### Sources

- CLI reference: https://terramate.io/docs/cli/reference/cmdline/
- Change detection docs: https://terramate.io/docs/cli/change-detection/
- Code generation docs: https://terramate.io/docs/cli/code-generation/
- Docs: https://terramate.io/docs
- Input package metadata: source_facts.package-manager
- README: https://github.com/terramate-io/terramate#readme
- Repository metadata: https://api.github.com/repos/terramate-io/terramate


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: <project>/**/*.tm.hcl, <project>/**/*.tm
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** terramate
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Conflicts With:** tenv
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - terramate: normalized package name match | nixpkgs package indexes: pkgs/by-name/te/terramate/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- winget - Terramate.CLI: normalized package name match | Windows Package Manager source index: Terramate.CLI from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [terragrunt](https://www.automicvault.com/pkg/brew/terragrunt/) - Shares av.db curated category or tags: cli, developer-tools, iac, infrastructure-as-code, opentofu.
- [terrahash](https://www.automicvault.com/pkg/brew/terrahash/) - Shares av.db curated category or tags: cli, developer-tools, iac, infrastructure-as-code, terraform.
- [terrahelp](https://www.automicvault.com/pkg/brew/terrahelp/) - Shares av.db curated category or tags: cli, developer-tools, iac, infrastructure-as-code, terraform.
- [terratag](https://www.automicvault.com/pkg/brew/terratag/) - Shares av.db curated category or tags: cli, developer-tools, iac, infrastructure-as-code, terraform.
- [tfschema](https://www.automicvault.com/pkg/brew/tfschema/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure-as-code, opentofu, terraform.
- [tfupdate](https://www.automicvault.com/pkg/brew/tfupdate/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure-as-code, opentofu, terraform.
- [tofu-ls](https://www.automicvault.com/pkg/brew/tofu-ls/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure-as-code, opentofu, terraform.
- [iam-policy-json-to-terraform](https://www.automicvault.com/pkg/brew/iam-policy-json-to-terraform/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure-as-code, terraform.

## Combined YAML source

View the package source record on GitHub. [combined/terramate.yml](https://github.com/automic-vault/db/blob/main/combined/terramate.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
