Automic VaultAutomic Vault

brew

Install terraform-local with Homebrew, Nix

CLI wrapper to deploy your Terraform applications directly to LocalStack. Version 0.26.0 via Homebrew; verified 2026-05-15.

install

Additional install commands

macOS

Homebrewverified · 100%
brew install terraform-local

local Homebrew formula metadata

Linux

Nixverified · 92%
nix profile install nixpkgs#terraform-local

nixpkgs package indexes · pkgs/by-name/te/terraform-local/package.nix · source: api.github.com

overview

Package summary

CLI wrapper to deploy your Terraform applications directly to LocalStack

Commands and aliases

  • tflocal
  • tflocal.bat

history

Project history and usage

terraform-local provides `tflocal`, a wrapper that runs Terraform against LocalStack by temporarily configuring AWS provider endpoints to point at the local LocalStack API.

Project history

The localstack/terraform-local repository was created on GitHub in March 2022. Its README describes a small wrapper script that uses Terraform's override mechanism to create a temporary `localstack_providers_override.tf` file, causing AWS provider endpoints to point to LocalStack, usually at `http://localhost:4566`.

The README's changelog starts at v0.1 and records a steady series of practical compatibility fixes: custom endpoints, `-chdir` support, provider aliases, local S3 backend handling, AWS provider version compatibility, multi-account support, semantic versioning, `AWS_ENDPOINT_URL`, dry-run behavior, additional override locations, and Terraform AWS provider 6 beta support.

Adoption history

terraform-local's adoption is tied to LocalStack's broader use as a local AWS emulator. Developers install `tflocal` when they want Terraform plans and applies to provision local AWS-like resources without rewriting normal Terraform modules for a test environment.

The input package facts list Homebrew and Nix packaging, while the official README recommends pipx and also documents virtualenv installation. That split is typical for Python CLIs that are useful both to Python package users and to infrastructure engineers who prefer system package managers.

How it is used

The main usage model is intentionally simple: run `tflocal` with the same arguments one would pass to `terraform`. The wrapper writes temporary provider override files, sets LocalStack service endpoints, and then invokes the configured Terraform command.

The README exposes most behavior through environment variables such as `DRY_RUN`, `TF_CMD`, `AWS_ENDPOINT_URL`, `S3_HOSTNAME`, `USE_EXEC`, service-specific endpoint variables, `AWS_DEFAULT_REGION`, `AWS_ACCESS_KEY_ID`, `SKIP_ALIASES`, and `ADDITIONAL_TF_OVERRIDE_LOCATIONS`.

Why package nerds care

terraform-local is package-nerd significant because it is deliberately a wrapper rather than a fork or provider. It preserves the user's Terraform CLI muscle memory while interposing just enough endpoint configuration to make LocalStack work as a local target.

For users curating developer machines, CI images, or reproducible test environments, `tflocal` is the installable bridge between Terraform's upstream binary and LocalStack's AWS emulation.

Timeline

  • 2022: GitHub repository created.
  • 2022: README changelog records v0.1 as the initial release.
  • 2023: Changelog entries added provider aliases, S3 backend support, and multi-account support.
  • 2024: Changelog records semantic versioning and `AWS_ENDPOINT_URL` support in v0.16.0.
  • 2025: Changelog records Terraform AWS provider 6.0.0-beta2 compatibility in v0.23.1.
  • 2026: Repository remained active during research.

Related projects

  • The official documentation and README tie terraform-local to LocalStack, Terraform, the Terraform AWS provider, Terraform override files, and local S3 backend workflows.

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for terraform-local. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Installs with 1 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

CommandKindExposureNote
tflocalcliglobal executable
tflocal.batcliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version0.26.0
manager updated2026-05-15
local dataok
upstreamnot checked
latest detectednot detected

https://localstack.cloud/

install metadata

Package metadata

Package keybrew:terraform-local
Version0.26.0
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/terraform-local
Homepagehttps://localstack.cloud/
Repositoryhttps://github.com/localstack/terraform-local
Upstream docshttps://docs.localstack.cloud/aws/integrations/infrastructure-as-code/terraform
LicenseApache-2.0
Source archivehttps://files.pythonhosted.org/packages/b9/f7/7d128b483dfd03d178c37eedc8c9329d7ee0abc4781bcfe5a0069ee63d79/terraform_local-0.26.0.tar.gz
Last updated2026-05-15T11:14:19Z
Pulseupdated
Dependenciespython@3.14
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Nameterraform-local
Version Scheme0
Revision1
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

terraform-local

nix profile install nixpkgs#terraform-local
  • normalized package name match
  • Matched by: Terraform Local
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/te/terraform-local/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

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