tenv

1. About The Project
   • Key Features
   • Difference with asdf
2. Table of contents
3. Getting Started
   • Prerequisites
   • Installation
4. Usage
5. Environment variables
6. Version files
7. Troubleshooting
8. Technical details
9. Verifying tenv Signatures
10. Contributing
11. Community
12. Authors
13. Licence

Installation via Homebrew:

brew install cosign

Installation via MacPorts:

sudo port install cosign

go install github.com/sigstore/cosign/v2/cmd/cosign@latest

apk add cosign

sudo pacman -S cosign

emerge --ask app-containers/cosign

LATEST_VERSION=$(curl https://api.github.com/repos/sigstore/cosign/releases/latest | jq -r .tag_name | tr -d "v")
curl -O -L "https://github.com/sigstore/cosign/releases/latest/download/cosign-${LATEST_VERSION}-1.x86_64.rpm"
sudo rpm -ivh cosign-${LATEST_VERSION}-1.x86_64.rpm

LATEST_VERSION=$(curl https://api.github.com/repos/sigstore/cosign/releases/latest | jq -r .tag_name | tr -d "v")
curl -O -L "https://github.com/sigstore/cosign/releases/latest/download/cosign_${LATEST_VERSION}_amd64.deb"
sudo dpkg -i cosign_${LATEST_VERSION}_amd64.deb

This package is available on the Arch Linux User Repository. It can be installed using the yay AUR helper:

yay tenv-bin

Installation via Nix package manager:

nix-env -i tenv

Installation via Homebrew:

brew install tenv

Installation via MacPorts:

sudo port install tenv

Installation via Nix package manager:

nix-env -i tenv

Installation via Chocolatey:

choco install tenv

Installation via Scoop:

scoop install tenv

Installation via Nix package manager:

nix-env -i tenv

Installation via WinGet package manager:

winget install Tofuutils.Tenv

snap install tenv

apk add tenv --repository=http://dl-cdn.alpinelinux.org/alpine/edge/testing/

Installation via Cloudsmith Artifact Management platform.

Setup Cloudsmith repository automatically:

sudo apk add --no-cache bash
curl -1sLf 'https://dl.cloudsmith.io/public/tofuutils/tenv/cfg/setup/bash.alpine.sh' | sudo bash

Install via apk:

apk add tenv

Install via dpkg

LATEST_VERSION=$(curl --silent https://api.github.com/repos/tofuutils/tenv/releases/latest | jq -r .tag_name)
curl -O -L "https://github.com/tofuutils/tenv/releases/latest/download/tenv_${LATEST_VERSION}_amd64.deb"
sudo dpkg -i "tenv_${LATEST_VERSION}_amd64.deb"

Install via Nix

Installation via Nix package manager:

nix-env -i tenv

Installation via Cloudsmith Artifact Management platform.

Setup Cloudsmith repository automatically:

curl -1sLf 'https://dl.cloudsmith.io/public/tofuutils/tenv/cfg/setup/bash.deb.sh' | sudo bash

Install via apt:

sudo apt install tenv

Installation via Cloudsmith Artifact Management platform.

Setup Cloudsmith repository automatically:

curl -1sLf 'https://dl.cloudsmith.io/public/tofuutils/tenv/cfg/setup/bash.rpm.sh' | sudo bash

Install via yum:

sudo yum install tenv

nix-env

nix-env -iA nixos.tenv

NixOS Configuration

Add the following Nix code to your NixOS Configuration, usually located in /etc/nixos/configuration.nix

environment.systemPackages = [
    pkgs.tenv
  ];

nix-shell

nix-shell -p tenv

tenv is not yet packaged in the official Gentoo repository or in the GURU community overlay, so install the binaries from the release archive:

TENV_VERSION=$(curl --silent https://api.github.com/repos/tofuutils/tenv/releases/latest | jq -r .tag_name)
curl -O -L "https://github.com/tofuutils/tenv/releases/latest/download/tenv_${TENV_VERSION}_Linux_x86_64.tar.gz"
tar -xzf "tenv_${TENV_VERSION}_Linux_x86_64.tar.gz"
sudo install -m 0755 tenv tf tofu terraform terragrunt terramate atmos -t /usr/local/bin

On Gentoo, Portage manages a single system version of Terraform (app-admin/terraform): tenv complements it by managing multiple OpenTofu, Terraform, Terragrunt, Terramate and Atmos versions per project in the TENV_ROOT directory (~/.tenv by default).

tenv completion zsh > ~/.tenv.completion.zsh
echo "source \$HOME/.tenv.completion.zsh" >> ~/.zshrc

tenv completion zsh > ~/.oh-my-zsh/completions/_tenv

Make sure the completions folder ~/.oh-my-zsh/completions is listed under $fpath:

print -l $fpath

tenv completion powershell | Out-String | Invoke-Expression

tenv completion bash > ~/.tenv.completion.bash
echo "source \$HOME/.tenv.completion.bash" >> ~/.bashrc

tenv completion fish > ~/.tenv.completion.fish
echo "source \$HOME/.tenv.completion.fish" >> ~/.config/fish/config.fish

Install a requested version of the tool (into TENV_ROOT directory from <TOOL>_REMOTE url).

Without a parameter, the version to use is resolved automatically (see resolution order in tools description, with latest as default in place of latest-allowed).

If a parameter is passed, available options include:

• an exact Semver 2.0.0 version string to install.
• a version constraint string (checked against versions available at <TOOL>_REMOTE url).
• latest, latest-stable (old name of latest) or latest-pre (include unstable version), which are checked against versions available at <TOOL>_REMOTE url.
• latest:<re> or min:<re> to get first version matching with <re> as a regexp after a descending or ascending version sort.
• latest-allowed or min-required to scan your IAC files to detect which version is maximally allowed or minimally required. See required_version docs.

tenv tofu install
tenv tofu install 1.6.0-beta5
tenv tf install "~> 1.6.0"
tenv tf install latest-pre
tenv tg install latest
tenv tg install latest-stable
tenv atmos install "~> 1.70"
tenv atmos install latest
tenv <tool> install latest-allowed
tenv <tool> install min-required

A complete display :

$ tenv tofu install 1.6.0
Installing OpenTofu 1.6.0
Fetching release information from https://api.github.com/repos/opentofu/opentofu/releases/tags/v1.6.0
Downloading https://github.com/opentofu/opentofu/releases/download/v1.6.0/tofu_1.6.0_linux_amd64.zip
Downloading https://github.com/opentofu/opentofu/releases/download/v1.6.0/tofu_1.6.0_SHA256SUMS
Downloading https://github.com/opentofu/opentofu/releases/download/v1.6.0/tofu_1.6.0_SHA256SUMS.sig
Downloading https://github.com/opentofu/opentofu/releases/download/v1.6.0/tofu_1.6.0_SHA256SUMS.pem
Installation of OpenTofu 1.6.0 successful

Switch the default tool version to use (set in TENV_ROOT/<TOOL>/version file).

tenv <tool> use has a --working-dir, -w flag to write a version file in working directory.

Available parameter options:

• an exact Semver 2.0.0 version string to use.
• a version constraint string (checked against versions available in TENV_ROOT directory).
• latest, latest-stable (old name of latest) or latest-pre (include unstable version), which are checked against versions available in TENV_ROOT directory.
• latest:<re> or min:<re> to get first version matching with <re> as a regexp after a descending or ascending version sort.
• latest-allowed or min-required to scan your IAC files to detect which version is maximally allowed or minimally required. See required_version docs.

tenv tofu use v1.6.0-beta5
tenv tf use min-required
tenv tg use latest
tenv atmos use latest
tenv tofu use latest-allowed

Detect the used version of tool for the working directory.

$ tenv tofu detect
No version files found for OpenTofu, fallback to latest-allowed strategy
Scan project to find .tf files
No OpenTofu version requirement found in project files, fallback to latest strategy
Found compatible version installed locally : 1.6.1
OpenTofu 1.6.1 will be run from this directory.
$ tenv tg detect -q
Terragrunt 0.55.1 will be run from this directory.
$ tenv atmos detect -q
Atmos 1.72.0 will be run from this directory.

Reset used version of tool (remove TENV_ROOT/<TOOL>/version file).

$ tenv tofu reset
Removed /home/dvaumoron/.tenv/OpenTofu/version

Uninstall versions of the tool (remove it from TENV_ROOT directory).

Without parameter, display an interactive list to select several versions.

If a parameter is passed, available parameter options:

• an exact Semver 2.0.0 version string to remove (no confirmation required)
• a version constraint string
• all
• but-last (all versions except the highest installed)
• not-used-for:<duration>, <duration> in days or months, like “14d” or “2m”
• not-used-since:<date>, <date> format is YYYY-MM-DD, like “2024-06-30”

$ tenv tofu uninstall v1.6.0-alpha4
Uninstallation of OpenTofu 1.6.0-alpha4 successful (directory /home/dvaumoron/.tenv/OpenTofu/1.6.0-alpha4 removed)

List installed tool versions (located in TENV_ROOT directory), sorted in ascending version order.

tenv <tool> list has a --descending, -d flag to sort in descending order.

$ tenv tofu list -v
* 1.6.0 (set by /home/dvaumoron/.tenv/OpenTofu/version)
  1.6.1
found 2 OpenTofu version(s) managed by tenv.

List installable tool versions (from <TOOL>_REMOTE url), sorted in ascending version order.

tenv <tool> list-remote has a --descending, -d flag to sort in descending order.

tenv <tool> list-remote has a --stable, -s flag to display only stable version.

$ tenv tofu list-remote
Fetching all releases information from https://api.github.com/repos/opentofu/opentofu/releases
1.6.0-alpha1
1.6.0-alpha2
1.6.0-alpha3
1.6.0-alpha4
1.6.0-alpha5
1.6.0-beta1
1.6.0-beta2
1.6.0-beta3
1.6.0-beta4
1.6.0-beta5
1.6.0-rc1
1.6.0 (installed)
1.6.1 (installed)

Set or reset a default constraint expression for the tool.

$ tenv tf constraint "<= 1.5.7"
Written <= 1.5.7 in /home/dvaumoron/.tenv/Terraform/constraint

Or without expression :

$ tenv tg constraint
Removed /home/dvaumoron/.tenv/Terragrunt/constraint

Help about any command.

You can use --help -h flag instead.

$ tenv help tf detect
Display Terraform current version.

Usage:
  tenv tf detect [flags]

Flags:
  -a, --arch string          specify arch for binaries downloading (default "amd64")
  -f, --force-remote         force search on versions available at TFENV_REMOTE url
  -h, --help                 help for detect
  -k, --key-file string      local path to PGP public key file (replace check against remote one)
  -n, --no-install           disable installation of missing version
  -c, --remote-conf string   path to remote configuration file (advanced settings)
  -u, --remote-url string    remote url to install from

Global Flags:
  -q, --quiet              no unnecessary output (and no log)
  -r, --root-path string   local path to install versions of OpenTofu, Terraform and Terragrunt (default "/home/dvaumoron/.tenv")
  -v, --verbose            verbose output (and set log level to Trace)

$ tenv tofu use -h
Switch the default OpenTofu version to use (set in TENV_ROOT/OpenTofu/version file)

Available parameter options:
- an exact Semver 2.0.0 version string to use
- a version constraint expression (checked against version available in TENV_ROOT directory)
- latest, latest-stable or latest-pre (checked against version available in TENV_ROOT directory)
- latest-allowed or min-required to scan your OpenTofu files to detect which version is maximally allowed or minimally required.

Usage:
  tenv tofu use version [flags]

Flags:
  -a, --arch string           specify arch for binaries downloading (default "amd64")
  -f, --force-remote          force search on versions available at TOFUENV_REMOTE url
  -t, --github-token string   GitHub token (increases GitHub REST API rate limits)
  -h, --help                  help for use
  -k, --key-file string       local path to PGP public key file (replace check against remote one)
  -n, --no-install            disable installation of missing version
  -c, --remote-conf string    path to remote configuration file (advanced settings)
  -u, --remote-url string     remote url to install from
  -w, --working-dir           create .opentofu-version file in working directory

Global Flags:
  -q, --quiet              no unnecessary output (and no log)
  -r, --root-path string   local path to install versions of OpenTofu, Terraform and Terragrunt (default "/home/dvaumoron/.tenv")
  -v, --verbose            verbose output (and set log level to Trace)

Display PATH updated with tenv directory location first. With GITHUB_ACTIONS set to true, write tenv directory location to GITHUB_PATH.

This command can be used when one of the managed tool is already installed on your system and hide the corresponding proxy (in that case which tenv and which <tool> will indicate different locations). The following shell call should resolve such issues :

export PATH=$(tenv update-path)

Display tenv current version.

$ tenv version
tenv version v1.7.0

String (Default: current tenv binaries architecture)

Allow to override the default architecture for binaries downloading during installation.

tenv <tool> subcommands detect, install and use support a --arch, -a flag version.

String (Default: false)

If set to true tenv will automatically install missing tool versions needed.

tenv <tool> subcommands detect and use support a --install, -i enabling flag, and a --no-install, -n disabling flag.

String (Default: false)

If set to true tenv detection of needed version will skip local check and verify compatibility on remote list.

tenv <tool> subcommands detect and use support a --force-remote, -f flag version.

String (Default: “”)

Allow to specify a GitHub token to increase GitHub Rate limits for the REST API. Useful because OpenTofu, Terragrunt and Atmos binaries are downloaded from GitHub repository.

tenv tofu and tenv tg subcommands detect, install, list-remote and use support a --github-token, -t flag version.

String (Default: “”)

The numeric ID of a GitHub App. When set (and TENV_GITHUB_TOKEN is not), tenv generates a short-lived installation access token from the App credentials and uses it as the bearer token for GitHub API calls. This is useful in CI systems (e.g. Atlantis) that already authenticate via a GitHub App, and raises the rate limit to 15,000 requests/hour per installation. Requires one of TENV_GITHUB_APP_PEM or TENV_GITHUB_APP_PEM_FILE to also be set.

String (Default: “”)

The numeric installation ID of the GitHub App. Optional: when omitted, tenv auto-discovers it by querying the App’s installations with the App JWT and using the first one returned. Set it explicitly when the App has more than one installation. Only used when TENV_GITHUB_APP_ID is set.

String (Default: “”)

The GitHub App’s RSA private key as an inline PEM string. Alternative to TENV_GITHUB_APP_PEM_FILE; takes precedence over it when both are set. Only used when TENV_GITHUB_APP_ID is set.

String (Default: “”)

Path to a file containing the GitHub App’s RSA private key in PEM format. Alternative to TENV_GITHUB_APP_PEM. Only used when TENV_GITHUB_APP_ID is set.

String (Default: false)

If set to true tenv disable unnecessary output (including log level forced to off).

tenv subcommands support a --quiet, -q flag version.

String (Default: “warn”)

Set tenv log level (possibilities sorted by decreasing verbosity : “trace”, “debug”, “info”, “warn”, “error”, “off”).

tenv support a --verbose, -v flag which set log level to “trace”.

String (Default: ${TENV_ROOT}/remote.yaml)

The path to a yaml file for advanced remote configuration (can be used to call artifact mirror).

tenv <tool> subcommands detect, install, list-remote and use support a --remote-conf, -c flag version.

String (Default: ${HOME}/.tenv)

The path to a directory where the local OpenTofu versions, Terraform versions, Terragrunt versions and tenv configuration files exist.

tenv support a --root-path, -r flag version.

String (Default: false)

If set to true tenv disable tracking of last use date for installed versions. It allow to avoid warning message when tenv is installed as root user and run with a normal user by skipping the writing of last-use.txt. This will lead to misselection with not-used-for and not-used-since behavior of tenv uninstall.

String (Default: signature)

Set tenv validation, known values are “signature” (check SHA256 and its signature, see signature support), “sha” (only check SHA256), “none” (no validation).

String (Default: false)

If set to true tenv proxies exposes proxied output stdout, stderr, and exitcode by writing them into GITHUB_OUTPUT in multiline format. GitHub Actions set it (see default environment variables).

String (Default: “”)

Needed when GITHUB_ACTIONS is set to true, path to a file to write proxied output.

String (Default: “”)

Used by tenv update-path when GITHUB_ACTIONS is set to true, path to a file to write tenv directory location.

String (Default: false)

Switch tofu proxy to an agnostic proxy (behave like tf, see resolution order).

Same as TENV_ARCH (compatibility with tofuenv).

Same as TENV_AUTO_INSTALL (compatibility with tofuenv).

Example 1

Use OpenTofu version 1.6.1 that is not installed, and auto installation stay disabled :

$ tenv use 1.6.1
Written 1.6.1 in /home/dvaumoron/.tenv/OpenTofu/version

Example 2

Use OpenTofu version 1.6.0 that is not installed, and auto installation is enabled :

$ TOFUENV_AUTO_INSTALL=true tenv tofu use 1.6.0
Installing OpenTofu 1.6.0
Fetching release information from https://api.github.com/repos/opentofu/opentofu/releases/tags/v1.6.0
Downloading https://github.com/opentofu/opentofu/releases/download/v1.6.0/tofu_1.6.0_linux_amd64.zip
Downloading https://github.com/opentofu/opentofu/releases/download/v1.6.0/tofu_1.6.0_SHA256SUMS
Downloading https://github.com/opentofu/opentofu/releases/download/v1.6.0/tofu_1.6.0_SHA256SUMS.sig
Downloading https://github.com/opentofu/opentofu/releases/download/v1.6.0/tofu_1.6.0_SHA256SUMS.pem
Installation of OpenTofu 1.6.0 successful
Written 1.6.0 in /home/dvaumoron/.tenv/OpenTofu/version

Same as TENV_FORCE_REMOTE.

String (the default depend on TOFUENV_REMOTE, without change on it, it is “api” else it is “direct”)

• “api” install mode retrieve download url of OpenTofu from Github REST API (TOFUENV_REMOTE must comply with it).
• “direct” install mode generate download url of OpenTofu based on TOFUENV_REMOTE.
• “mirror” install mode generate download url with TOFUENV_URL_TEMPLATE (as specified in TofuDL mirror specification)

See advanced remote configuration for more details.

String (the default depend on TOFUENV_LIST_URL, without change on it, it is “api” else it is “html”)

• “api” list mode retrieve information of OpenTofu releases from Github REST API (TOFUENV_LIST_URL must comply with it).
• “html” list mode extract information of OpenTofu releases from parsing an html page at TOFUENV_LIST_URL.
• “mirror” list mode retrieve information of OpenTofu releases at TOFUENV_LIST_URL as TofuDL Mirroring format

See advanced remote configuration for more details.

String (Default: copy TOFUENV_REMOTE, default is overloaded by “https://get.opentofu.org/tofu/api.json” when TOFUENV_LIST_MODE is “mirror”)

Allow to override the remote url only for the releases listing.

See advanced remote configuration for more details.

String (Default: “”)

Allow to specify a local file path or URL to OpenTofu PGP public key. If a URL is provided (starting with “http://” or “https://”), the key will be downloaded from that URL. If a local file path is provided, the key will be read from that location. If not set, the key will be downloaded from the default URL (https://get.opentofu.org/opentofu.asc).

tenv tofu subcommands detect, ìnstall and use support a --key-file, -k flag version.

String (Default: https://api.github.com/repos/opentofu/opentofu/releases)

URL to install OpenTofu, when TOFUENV_REMOTE differ from its default value, TOFUENV_INSTALL_MODE is set to “direct” and TOFUENV_LIST_MODE is set to “html” (assume an artifact proxy usage).

tenv tofu subcommands detect, install, list-remote and use support a --remote-url, -u flag version.

See advanced remote configuration for more details.

String (Default: “”)

Could be used with TOFUENV_REMOTE_USER to specify HTTP basic auth when same credential are used with TOFUENV_REMOTE and TOFUENV_LIST_URL (instead of https://user:[email protected] URL format).

String (Default: “”)

Could be used with TOFUENV_REMOTE_PASSWORD to specify HTTP basic auth when same credential are used with TOFUENV_REMOTE and TOFUENV_LIST_URL (instead of https://user:[email protected] URL format).

Same as TENV_ROOT (compatibility with tofuenv).

String (Default: https://github.com/opentofu/opentofu/releases/download/v{{ .Version }}/{{ .Artifact }})

Used when TOFUENV_INSTALL_MODE is “mirror” (see TofuDL mirror specification).

Same as TENV_GITHUB_TOKEN (compatibility with tofuenv).

String (Default: “”)

If not empty string, this variable overrides OpenTofu default constraint, specified in ${TENV_ROOT}/OpenTofu/constraint file.

String (Default: “”)

If not empty string, this variable overrides OpenTofu fallback version, specified in ${TENV_ROOT}/OpenTofu/version file.

String (Default: “”)

If not empty string, this variable overrides OpenTofu version, specified in .opentofu-version files.

tenv tofu subcommands install and detect also respects this variable.

e.g. with :

$ tofu version
OpenTofu v1.6.1
on linux_amd64

then :

$ TOFUENV_TOFU_VERSION=1.6.0 tofu version
OpenTofu v1.6.0
on linux_amd64

String (Default: false)

Switch terraform proxy to an agnostic proxy (behave like tf, see resolution order).

Same as TENV_ARCH (compatibility with tfenv).

Same as TENV_AUTO_INSTALL (compatibility with tfenv).

Same as TENV_FORCE_REMOTE.

Allow to specify a local file path or URL to Hashicorp PGP public key. If a URL is provided (starting with “http://” or “https://”), the key will be downloaded from that URL. If a local file path is provided, the key will be read from that location. If not set, the key will be downloaded from the default URL (https://www.hashicorp.com/.well-known/pgp-key.txt).

tenv tf subcommands detect, ìnstall and use support a --key-file, -k flag version.

String (Default: “api”)

• “api” install mode retrieve download url of Terraform from Hashicorp Release API (TFENV_REMOTE must comply with it).
• “direct” install mode generate download url of Terraform based on TFENV_REMOTE.

See advanced remote configuration for more details.

String (the default depend on TFENV_LIST_URL, without change on it, it is “api” else it is “html”)

• “api” list mode retrieve information of Terraform releases from Hashicorp Release API (TFENV_LIST_URL must comply with it).
• “html” list mode extract information of Terraform releases from parsing an html page in TFENV_LIST_URL.

See advanced remote configuration for more details.

String (Default: copy TFENV_REMOTE)

Allow to override the remote url only for the releases listing.

See advanced remote configuration for more details.

String (Default: https://releases.hashicorp.com)

URL to install Terraform, changing it assume an artifact proxy use (TFENV_LIST_URL copy it, and if it differ from its default value, TFENV_LIST_MODE is set to “html”, because an artifact proxy usage will not disturb the retrieving of index.json for a release, but will freeze the json list of releases).

tenv tf subcommands detect, install, list-remote and use support a --remote-url, -u flag version.

See advanced remote configuration for more details.

String (Default: “”)

Could be used with TFENV_REMOTE_USER to specify HTTP basic auth when same credential are used with TFENV_REMOTE and TFENV_LIST_URL (instead of https://user:[email protected] URL format).

String (Default: “”)

Could be used with TFENV_REMOTE_PASSWORD to specify HTTP basic auth when same credential are used with TFENV_REMOTE and TFENV_LIST_URL (instead of https://user:[email protected] URL format).

Same as TENV_ROOT (compatibility with tfenv).

String (Default: “”)

If not empty string, this variable overrides Terraform default constraint, specified in ${TENV_ROOT}/Terraform/constraint file.

String (Default: “”)

If not empty string, this variable overrides Terraform fallback version, specified in ${TENV_ROOT}/Terraform/version file.

String (Default: “”)

If not empty string, this variable overrides Terraform version, specified in .terraform-version files.

tenv tf subcommands install and detect also respects this variable.

e.g. with :

$ terraform version
Terraform v1.7.2
on linux_amd64

then :

$ TFENV_TERRAFORM_VERSION=1.7.0 terraform version
Terraform v1.7.0
on linux_amd64

Your version of Terraform is out of date! The latest version
is 1.7.2. You can update by downloading from https://www.terraform.io/downloads.html

String (the default depend on TG_REMOTE, without change on it, it is “api” else it is “direct”)

• “api” install mode retrieve download url of Terragrunt from Github REST API (TG_REMOTE must comply with it).
• “direct” install mode generate download url of Terragrunt based on TG_REMOTE.

See advanced remote configuration for more details.

String (the default depend on TG_LIST_URL, without change on it, it is “api” else it is “html”)

• “api” list mode retrieve information of Terragrunt releases from Github REST API (TG_LIST_URL must comply with it).
• “html” list mode extract information of Terragrunt releases from parsing an html page in TG_LIST_URL.

See advanced remote configuration for more details.

String (Default: copy TG_REMOTE)

Allow to override the remote url only for the releases listing.

See advanced remote configuration for more details.

String (Default: https://api.github.com/repos/gruntwork-io/terragrunt/releases)

URL to install Terragrunt, when TG_REMOTE differ from its default value, TG_INSTALL_MODE is set to “direct” and TG_LIST_MODE is set to “html” (assume an artifact proxy usage).

tenv tg subcommands detect, install, list-remote and use support a --remote-url, -u flag version.

See advanced remote configuration for more details.

String (Default: “”)

Could be used with TG_REMOTE_USER to specify HTTP basic auth when same credential are used with TG_REMOTE and TG_LIST_URL (instead of https://user:[email protected] URL format).

String (Default: “”)

Could be used with TG_REMOTE_PASSWORD to specify HTTP basic auth when same credential are used with TG_REMOTE and TG_LIST_URL (instead of https://user:[email protected] URL format).

String (Default: “”)

If not empty string, this variable overrides Terragrunt default constraint, specified in ${TENV_ROOT}/Terragrunt/constraint file.

String (Default: “”)

If not empty string, this variable overrides Terragrunt fallback version, specified in ${TENV_ROOT}/Terragrunt/version file.

String (Default: “”)

If not empty string, this variable overrides Terragrunt version, specified in .terragrunt-version files.

tenv tg subcommands install and detect also respects this variable.

e.g. with :

$ terragrunt -v
terragrunt version v0.55.1

then :

$ TG_VERSION=0.54.1 terragrunt -v
terragrunt version v0.54.1

String (the default depend on TM_REMOTE, without change on it, it is “api” else it is “direct”)

• “api” install mode retrieve download url of Terramate from Github REST API (TM_REMOTE must comply with it).
• “direct” install mode generate download url of Terramate based on TM_REMOTE.

See advanced remote configuration for more details.

String (the default depend on TM_LIST_URL, without change on it, it is “api” else it is “html”)

• “api” list mode retrieve information of Terramate releases from Github REST API (TM_LIST_URL must comply with it).
• “html” list mode extract information of Terramate releases from parsing an html page in TM_LIST_URL.

See advanced remote configuration for more details.

String (Default: copy TM_REMOTE)

Allow to override the remote url only for the releases listing.

See advanced remote configuration for more details.

String (Default: https://api.github.com/repos/terramate-io/terramate/releases)

URL to install Terramate, when TM_REMOTE differ from its default value, TM_INSTALL_MODE is set to “direct” and TM_LIST_MODE is set to “html” (assume an artifact proxy usage).

tenv tm subcommands detect, install, list-remote and use support a --remote-url, -u flag version.

See advanced remote configuration for more details.

String (Default: “”)

Could be used with TM_REMOTE_USER to specify HTTP basic auth when same credential are used with TM_REMOTE and TM_LIST_URL (instead of https://user:[email protected] URL format).

String (Default: “”)

Could be used with TM_REMOTE_PASSWORD to specify HTTP basic auth when same credential are used with TM_REMOTE and TM_LIST_URL (instead of https://user:[email protected] URL format).

String (Default: “”)

If not empty string, this variable overrides Terramate default constraint, specified in ${TENV_ROOT}/Terramate/constraint file.

String (Default: “”)

If not empty string, this variable overrides Terramate fallback version, specified in ${TENV_ROOT}/Terramate/version file.

String (Default: “”)

If not empty string, this variable overrides Terramate version, specified in .terramate-version files.

tenv tm subcommands install and detect also respects this variable.

e.g. with :

$ terramate version
0.13.0

then :

$ TM_VERSION=0.12.0 terramate version
0.12.0

String (the default depend on ATMOS_REMOTE, without change on it, it is “api” else it is “direct”)

• “api” install mode retrieve download url of Atmos from Github REST API (ATMOS_REMOTE must comply with it).
• “direct” install mode generate download url of Atmos based on ATMOS_REMOTE.

See advanced remote configuration for more details.

String (the default depend on ATMOS_LIST_URL, without change on it, it is “api” else it is “html”)

• “api” list mode retrieve information of Atmos releases from Github REST API (ATMOS_LIST_URL must comply with it).
• “html” list mode extract information of Atmos releases from parsing an html page in ATMOS_LIST_URL.

See advanced remote configuration for more details.

String (Default: copy ATMOS_REMOTE)

Allow to override the remote url only for the releases listing.

See advanced remote configuration for more details.

String (Default: https://api.github.com/repos/cloudposse/atmos/releases)

URL to install Atmos when ATMOS_REMOTE differ from its default value, ATMOS_INSTALL_MODE is set to “direct” and ATMOS_LIST_MODE is set to “html” (assume an artifact proxy usage).

tenv atmos subcommands detect, install, list-remote and use support a --remote-url, -u flag version.

See advanced remote configuration for more details.

String (Default: “”)

Could be used with ATMOS_REMOTE_USER to specify HTTP basic auth when same credential are used with ATMOS_REMOTE and ATMOS_LIST_URL (instead of https://user:[email protected] URL format).

String (Default: “”)

Could be used with ATMOS_REMOTE_PASSWORD to specify HTTP basic auth when same credential are used with ATMOS_REMOTE and ATMOS_LIST_URL (instead of https://user:[email protected] URL format).

String (Default: “”)

If not empty string, this variable overrides Atmos default constraint, specified in ${TENV_ROOT}/Atmos/constraint file.

String (Default: “”)

If not empty string, this variable overrides Atmos fallback version, specified in ${TENV_ROOT}/Atmos/version file.

String (Default: “”)

If not empty string, this variable overrides Atmos version, specified in .atmos-version files.

tenv atmos subcommands install and detect also respects this variable.

e.g. with :

$ atmos version
👽 Atmos v1.72.0 on linux/amd64

then :

$ ATMOS_VERSION=1.70 atmos version
👽 Atmos v1.70.0 on linux/amd64

The TENV_ROOT/<TOOL>/version file is the tool default version used when no project specific or user specific are found. It can be written with tenv <tool> use.

If you put a .opentofu-version file in the working directory, one of its parent directory, or user home directory, tenv detects it and uses the version written in it. Note, that TOFUENV_TOFU_VERSION can be used to override version specified by .opentofu-version file.

Recognize same values as tenv tofu use command.

See required_version docs.

If you put a .terraform-version or .tfswitchrc file in the working directory, one of its parent directory, or user home directory, tenv detects it and uses the version written in it. Note, that TFENV_TERRAFORM_VERSION can be used to override version specified by those files.

Recognize same values as tenv tf use command.

See required_version docs.

If you put a .terragrunt-version or a .tgswitchrc file in the working directory, one of its parent directory, or user home directory, tenv detects it and uses the version written in it. tenv also detect a version field in a .tgswitch.toml in same places. Note, that TG_VERSION can be used to override version specified by those files.

Recognize same values as tenv tg use command.

Terragrunt now recommends using root.hcl instead of terragrunt.hcl as the root configuration file name.

If a terragrunt.hcl, root.hcl, or their .json equivalents exist in the working directory, a parent directory, or the user home directory, tenv will read constraints from the terraform_version_constraint or terragrunt_version_constraint field (depending on proxy or subcommand used).

If both root.hcl and terragrunt.hcl (or their .json versions) are present, terragrunt.hcl takes precedence.

If you put a .terramate-version file in the working directory, one of its parent directory, or user home directory, tenv detects it and uses the version written in it. Note, that TM_VERSION can be used to override version specified by those files.

Recognize same values as tenv tm use command.

If you put a .atmos-version file in the working directory, one of its parent directory, or user home directory, tenv detects it and uses the version written in it. Note, that ATMOS_VERSION can be used to override version specified by those files.

Recognize same values as tenv atmos use command.

the latest-allowed or min-required strategies scan through your IAC files (see list in project binaries) and identify a version conforming to the constraint in the relevant files. They fallback to latest when no IAC files and no default constraint are found, and can optionally be used with a default constraint as detailed in project binaries.

Currently the format for Terraform required_version and OpenTofu required_version are very similar, however this may change over time, always refer to docs for the latest format specification.

example:

version = ">= 1.2.0, < 2.0.0"

This would identify the latest version at or above 1.2.0 and below 2.0.0

The tofu command in this project is a proxy to OpenTofu’s tofu command managed by tenv.

The version resolution order is :

• TOFUENV_TOFU_VERSION environment variable
• .opentofu-version file
• .tool-versions file
• terraform_version_constraint from terragrunt.hcl file
• terraform_version_constraint from terragrunt.hcl.json file
• terraform_version_constraint from root.hcl file
• terraform_version_constraint from root.hcl.json file
• TOFUENV_TOFU_DEFAULT_VERSION environment variable
• ${TENV_ROOT}/OpenTofu/version file (can be written with tenv tofu use)
• latest-allowed

The latest-allowed strategy rely on required_version from .tofu, .tofu.json, .tf or .tf.json files with a fallback to latest when no constraint are found. Moreover it is possible to add a default constraint with TOFUENV_TOFU_DEFAULT_CONSTRAINT environment variable or ${TENV_ROOT}/OpenTofu/constraint file (can be written with tenv tofu constraint). The default constraint is added while using latest-allowed, min-required or custom constraint. A default constraint with latest-allowed or min-required will avoid the fallback to latest when there is no .tf or .tf.json files.

The terraform command in this project is a proxy to HashiCorp’s terraform command managed by tenv.

The version resolution order is :

• TFENV_TERRAFORM_VERSION environment variable
• .terraform-version file
• .tfswitchrc file
• .tool-versions file
• terraform_version_constraint from terragrunt.hcl file
• terraform_version_constraint from terragrunt.hcl.json file
• terraform_version_constraint from root.hcl file
• terraform_version_constraint from root.hcl.json file
• TFENV_TERRAFORM_DEFAULT_VERSION environment variable
• ${TENV_ROOT}/Terraform/version file (can be written with tenv tf use)
• latest-allowed

The latest-allowed strategy rely on required_version from .tf or .tf.json files with a fallback to latest when no constraint are found. Moreover it is possible to add a default constraint with TFENV_TERRAFORM_DEFAULT_CONSTRAINT environment variable or ${TENV_ROOT}/Terraform/constraint file (can be written with tenv tf constraint). The default constraint is added while using latest-allowed, min-required or custom constraint. A default constraint with latest-allowed or min-required will avoid the fallback to latest when there is no .tf or .tf.json files.

The terragrunt command in this project is a proxy to Gruntwork’s terragrunt command managed by tenv.

The version resolution order is :

• TG_VERSION environment variable
• .terragrunt-version file
• .tgswitchrc file
• version from tgswitch.toml file
• .tool-versions file
• terragrunt_version_constraint from terragrunt.hcl file
• terragrunt_version_constraint from terragrunt.hcl.json file
• terragrunt_version_constraint from root.hcl file
• terragrunt_version_constraint from root.hcl.json file
• TG_DEFAULT_VERSION environment variable
• ${TENV_ROOT}/Terragrunt/version file (can be written with tenv tg use)
• latest-allowed

The latest-allowed strategy has no information for Terragrunt and will fallback to latest unless there is default constraint. Adding a default constraint could be done with TG_DEFAULT_CONSTRAINT environment variable or ${TENV_ROOT}/Terragrunt/constraint file (can be written with tenv tg constraint). The default constraint is added while using latest-allowed, min-required or custom constraint. A default constraint with latest-allowed or min-required will avoid there fallback to latest.

The terramate command in this project is a proxy to Terramate’s terramate command managed by tenv.

The version resolution order is :

• TM_VERSION environment variable
• .terramate-version file
• TM_DEFAULT_VERSION environment variable
• ${TENV_ROOT}/Terramate/version file (can be written with tenv tm use)
• latest-allowed

The latest-allowed strategy has no information for Terramate and will fallback to latest unless there is default constraint. Adding a default constraint could be done with TM_DEFAULT_CONSTRAINT environment variable or ${TENV_ROOT}/Terramate/constraint file (can be written with tenv tm constraint). The default constraint is added while using latest-allowed, min-required or custom constraint. A default constraint with latest-allowed or min-required will avoid there fallback to latest.

The atmos command in this project is