{"id":15896174,"url":"https://github.com/aaratn/terraenv","last_synced_at":"2025-03-20T15:32:33.730Z","repository":{"id":35952557,"uuid":"221698182","full_name":"aaratn/terraenv","owner":"aaratn","description":"Terraform \u0026 Terragrunt Version Manager","archived":false,"fork":false,"pushed_at":"2022-12-26T21:31:22.000Z","size":48,"stargazers_count":85,"open_issues_count":9,"forks_count":12,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-01T00:23:25.256Z","etag":null,"topics":["linux","osx","python","rbenv","terraform","terragrunt","tfenv","version-manager"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aaratn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-11-14T12:58:13.000Z","updated_at":"2024-04-30T01:31:30.000Z","dependencies_parsed_at":"2023-01-16T09:44:14.217Z","dependency_job_id":null,"html_url":"https://github.com/aaratn/terraenv","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaratn%2Fterraenv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaratn%2Fterraenv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaratn%2Fterraenv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaratn%2Fterraenv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aaratn","download_url":"https://codeload.github.com/aaratn/terraenv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244075638,"owners_count":20393979,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linux","osx","python","rbenv","terraform","terragrunt","tfenv","version-manager"],"created_at":"2024-10-06T09:06:37.592Z","updated_at":"2025-03-20T15:32:33.443Z","avatar_url":"https://github.com/aaratn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Actions Status](https://github.com/aaratn/terraenv/workflows/Build%20\u0026%20Release/badge.svg)](https://github.com/aaratn/terraenv/actions)\n# terraenv\n\n![terraenv](https://repository-images.githubusercontent.com/221698182/e820d380-0bab-11ea-80b0-0f8a25a0d178\n)\n\n[Terraform](https://www.terraform.io/) \u0026 [Terragrunt](https://github.com/gruntwork-io/terragrunt) version manager inspired by [rbenv](https://github.com/rbenv/rbenv), [tfenv](https://github.com/tfutils/tfenv), [tgenv](https://github.com/cunymatthieu/tgenv)\n\n## Support\n\nCurrently terraenv supports the following Operating System\n\n- Mac OS X (64bit)\n- Linux (64bit)\n\n## Installation\n\n### Automatic\n\nInstall via Homebrew on OSx\n\n  ```console\n  $ brew tap aaratn/terraenv\n  $ brew install terraenv\n  ```\n\nInstall via Python pip\n\n  ```console\n  $ pip install terraenv\n  ```\n\n\n### Upgrade\n\nvia Homebrew on OSx\n\n  ```console\n  $ brew upgrade terraenv\n  ```\n\n### Manual on Linux And OSX\n\n1. Download terraenv for your operating system\n\n  Linux\n\n  ```console\n  $ wget https://github.com/aaratn/terraenv/releases/latest/download/terraenv_linux_x64.tar.gz\n  ```\n\n  OSX\n\n  ```console\n  $ wget https://github.com/aaratn/terraenv/releases/latest/download/terraenv_osx_x64.tar.gz\n  ```\n\n\n2. Extract Tar Archive\n\n  Linux\n  ```console\n  $ tar -xvzf terraenv_linux_x64.tar.gz\n  ```\n  OSX\n  ```console\n  $ tar -xvzf terraenv_osx_x64.tar.gz\n  ```\n\n3. Copy the extracted file to your `/usr/local/bin` directory\n\n  ```console\n  $ cp terraenv /usr/local/bin/terraenv\n  ```\n\n  On Ubuntu/Debian touching `/usr/local/bin` might require sudo access\n\n\n## Usage\n\n### terraenv \u003cterraform / terragrunt \u003e install [version]\n\nInstall a specific version of Terraform. Available options for version:\n\n- `1.2.3` exact version to install\n- `latest` installs latest version\n\n```console\n$ terraenv terraform install 0.12.15\n$ terraenv terragrunt install 0.21.6\n```\n\n```console\n$ terraenv terraform install latest\n$ terraenv terragrunt install latest\n```\n\n### terraenv \u003c terraform / terragrunt \u003e list remote\n\n#### .terraenv\n\nIf you use a [.terraenv](#.terraenv-file), `terraenv \u003cterraform / terragrunt \u003e install` (no argument) will install the version written in it.\n\n### terraenv \u0026lt;terraform/terragrunt\u003e use \u0026lt;version\u003e\n\nSwitch a version to use\n\n```console\n$ terraenv terraform use 0.11.14\n$ terraenv terragrunt use 0.21.6\n```\n\n### terraenv uninstall \u0026lt;terraform/terragrunt\u003e \u0026lt;version\u003e\n\nUninstall a specific version of Terraform\n\n```console\n$ terraenv terraform uninstall 0.12.15\n$ terraenv terragrunt uninstall 0.21.5\n```\n\n### terraenv \u0026lt;terraform/terragrunt\u003e list local\n\nList installed versions\n\n```console\n% terraenv terraform list local\n0.12\n0.11.13\n0.11.14\n0.12.11\n0.12.0\n0.12.12\n0.12.13\n```\n```console\n% terraenv terragrunt list local\n0.18.7\n0.21.6\n```\n\n### terraenv \u0026lt;terraform/terragrunt\u003e list remote\n\nList installable versions\n\n```console\n% terraenv terraform list remote\n...\n0.11.3\n0.11.4\n0.11.5\n0.11.6\n0.11.7\n0.11.8\n0.11.9\n0.11.10\n0.11.11\n0.11.12\n0.11.13\n0.11.14\n0.12.0\n0.12.1\n0.12.2\n0.12.3\n0.12.4\n0.12.5\n0.12.6\n0.12.7\n0.12.8\n0.12.9\n0.12.10\n0.12.11\n0.12.12\n0.12.13\n0.12.14\n0.12.15\n```\n\n## .terraenv file\n\nIf you put a `.terraenv` file on your project root, terraenv detects it and uses the version written in it.\n\n```console\n$ cat .terraenv\nTERRAFORM=0.12.15\nTERRAGRUNT=0.21.6\n\n$ terraenv terraform install\n\n$ terraform -version\nTerraform v0.12.15\n\n$ terraenv terragrunt install\n\n$ terragrunt -version\nterragrunt version v0.21.6\n\nTo use Terraform or Terragrunt version from `.terraenv` file present at your current directory path.\n\n$ terraenv terraform use\n\n$ terraenv terragrunt use\n```\n\n## LICENSE\n\n- [terraenv](https://github.com/aaratn/terraenv/blob/master/LICENSE)\n- [rbenv](https://github.com/rbenv/rbenv/blob/master/LICENSE)\n\n## Inspiration\n- [tfenv](https://github.com/tfutils/tfenv)\n- [tgenv](https://github.com/cunymatthieu/tgenv)\n- [rbenv](https://github.com/rbenv/rbenv)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaratn%2Fterraenv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faaratn%2Fterraenv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaratn%2Fterraenv/lists"}