How to install tofuenv on Windows?

Install Git Bash via winget, then clone the repo and add it to your PATH in .bashrc, but be prepared for symlink issues that can cause failures. The README notes it's 'presumed failing' in git-bash, so consider alternative tools for stable Windows use.

tofuenv vs tfenv: which one should I use?

Use tofuenv for OpenTofu-only management, as it's specifically designed for it, while tfenv is for Terraform. If you need both, check out tenv, the announced successor that supports both tools and is written in Go for better cross-platform support.

How to set up automatic version switching with tofuenv?

Create a .opentofu-version file in your project root with the version (e.g., 1.6.0 or latest:^1.6), and tofuenv will automatically use it when running tofu commands. You can override this with the TOFUENV_TOFU_VERSION environment variable.

Can tofuenv verify GPG signatures for OpenTofu binaries?

Yes, but it requires manual setup: create a use-gpgv file in the config directory with 'trust-tofuenv: yes' to enable verification using the OpenTofu GPG key from the repo. Note that keybase tool verification is not yet supported by OpenTofu.

What is the difference between tofuenv and tenv?

tofuenv is a Bash-based version manager for OpenTofu only, inspired by tfenv, while tenv is a newer Go-based tool that handles both Terraform and OpenTofu binaries. The developers recommend tenv for future-proofing and unified management.

How to fix symlink issues with tofuenv on Windows git-bash?

The README doesn't provide a fix, only noting presumed failures. Workarounds might involve adjusting git-bash settings or using Windows symlink commands, but for reliable operation, consider switching to Linux/macOS or using tenv when available.

Open-Awesome

tofuenv

MITShellv1.0.7

A version manager for OpenTofu, enabling easy installation and switching between different versions.

Visit Website GitHub

234 stars6 forks0 contributors

What is tofuenv?

tofuenv is a version manager for OpenTofu, designed to simplify the installation, management, and switching of OpenTofu versions across different environments. It provides a consistent workflow for developers and teams working with infrastructure as code, ensuring compatibility and reproducibility by handling multiple versions, automatic version resolution, and verification.

Target Audience

Infrastructure developers and teams using OpenTofu for infrastructure as code who need to manage multiple OpenTofu versions across projects or environments. It is particularly useful for those requiring reproducible builds and cross-platform compatibility.

Value Proposition

Developers choose tofuenv for its lightweight, script-based design that follows the Unix philosophy, seamless shell integration, and features like semantic version support, automatic version resolution from files, and optional GPG verification. It is a dedicated tool inspired by tfenv but specifically for OpenTofu.

Overview

OpenTofu version manager

Use Cases

Best For

Managing multiple OpenTofu versions on a single machine for different projects.
Automatically switching OpenTofu versions based on project-specific .opentofu-version files.
Installing OpenTofu prerelease builds (e.g., alpha, beta, RC) for testing new features.
Ensuring version compatibility and reproducibility in team environments with shared infrastructure code.
Using custom download sources like Artifactory in enterprise or restricted network environments.
Verifying OpenTofu binary integrity with optional GPG signature and SHA256 checksum verification.

Not Ideal For

Windows environments requiring a robust, native version manager without reliance on git-bash workarounds
Teams that need to manage both Terraform and OpenTofu versions with a single unified tool
Projects where minimizing external dependencies (like jq and gnupg) is a critical requirement

Pros & Cons

Pros

Automatic Version Resolution

Integrates with .opentofu-version files and TOFUENV_TOFU_VERSION environment variables to automatically switch OpenTofu versions, ensuring project-specific compatibility without manual intervention.

Semantic Version Flexibility

Supports exact semver, regex patterns like latest:^1.6, and can detect min-required or latest-allowed versions from OpenTofu configuration files, streamlining complex version management.

Enterprise Customization Options

Allows configuration of custom download remotes (e.g., Artifactory) via TOFUENV_REMOTE and optional GPG verification with use-gpgv files, catering to restricted networks and security needs.

Lightweight Shell Integration

Follows the Unix philosophy with script-based design, easily installed via Homebrew or manual clone, and integrates seamlessly into bash/zsh workflows without heavy overhead.

Cons

Fragile Windows Support

Only tested in git-bash with presumed symlink issues, making it unreliable for native Windows usage and requiring cumbersome workarounds that may fail in production environments.

Mandatory Dependency Overhead

Requires jq for JSON processing and optionally gnupg for verification, adding installation steps and potential compatibility problems, especially on minimal or locked-down systems.

Successor Announcement Uncertainty

The README actively promotes tenv as the future tool for both Terraform and OpenTofu, indicating that tofuenv may receive reduced updates and community focus over time.

Frequently Asked Questions

Related Projects

terraformer

CLI tool to generate terraform files from existing infrastructure (reverse Terraform). Infrastructure to Code

Stars14,559

Forks1,836

Last commit4 months ago

$Infracost$ Infracost

Cloud cost intelligence for engineers, AI coding agents, and CI/CD 💰📉 Shift FinOps Left!

Stars12,413

Forks679

Last commit21 days ago

Terragrunt

Terragrunt is a flexible orchestration tool that allows Infrastructure as Code written in OpenTofu/Terraform to scale.

Stars9,726

Forks1,215

Last commit12 hours ago

atlantis

Terraform Pull Request Automation

Stars9,200

Forks1,304

Last commit20 hours ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub