diff --git a/website/data/cli-nav-data.json b/website/data/cli-nav-data.json index 2bae97955c..ab233710c0 100644 --- a/website/data/cli-nav-data.json +++ b/website/data/cli-nav-data.json @@ -417,20 +417,6 @@ } ] }, - { - "title": "Installation", - "hidden": true, - "routes": [ - { - "title": "APT Packages for Debian and Ubuntu", - "path": "install/apt" - }, - { - "title": "Yum Packages for Red Hat Enterprise Linux, Fedora, and Amazon Linux", - "path": "install/yum" - } - ] - }, { "divider": true }, { "title": "Terraform Internals", "href": "/internals" } ] diff --git a/website/docs/cli/install/apt.mdx b/website/docs/cli/install/apt.mdx deleted file mode 100644 index 492d238ea2..0000000000 --- a/website/docs/cli/install/apt.mdx +++ /dev/null @@ -1,89 +0,0 @@ ---- -page_title: Install Terraform using APT packages for Debian and Ubuntu -description: >- - Learn how to install Terraform using HashiCorp APT packages for Debian and Ubuntu systems. ---- - -# Install Terraform Using APT Packages for Debian and Ubuntu - -The primary distribution packages for Terraform are `.zip` archives containing -single executable files that you can extract anywhere on your system. However, -for easier integration with configuration management tools and other systematic -system configuration strategies, we also offer package repositories for -Debian and Ubuntu systems, which allow you to install Terraform using the -`apt install` command or any other APT frontend. - -If you are instead using Red Hat Enterprise Linux, CentOS, or Fedora, you -might prefer to [install Terraform from our Yum repositories](/terraform/cli/install/yum). - --> **Note:** The APT repositories discussed on this page are generic HashiCorp -repositories that contain packages for a variety of different HashiCorp -products, rather than just Terraform. Adding these repositories to your -system will, by default, therefore make several other non-Terraform -packages available for installation. That might then mask some packages that -are available for some HashiCorp products in the main Debian and Ubuntu -package repositories. - -## Repository Configuration - -Please follow the instructions in the [Official Packaging Guide](https://www.hashicorp.com/official-packaging-guide). - -## Supported Architectures - -The HashiCorp APT server has packages only for the `amd64` -architecture, which is also sometimes known as `x86_64`. - -There are no official packages available for other architectures, such as -`arm64`. If you wish to use Terraform on a non-`amd64` system, -[download a normal release `.zip` file](/terraform/downloads) instead. - -## Supported Debian and Ubuntu Releases - -The HashiCorp APT server contains release repositories for a variety of -supported distributions, which are outlined in the [Official Packaging Guide](https://www.hashicorp.com/official-packaging-guide). - -## Installing a Specific Version of Terraform - -The HashiCorp APT repositories contain multiple versions of Terraform, but -because the packages are all named `terraform` it is impossible to install -more than one version at a time, and `apt install` will default to selecting -the latest version. - -It's often necessary to match your Terraform version with what a particular -configuration is currently expecting. You can use the following command to -see which versions are currently available in the repository index: - -```bash -apt policy terraform -``` - -If your workflow requires using multiple versions of Terraform at the same -time, for example when working through a gradual upgrade where not all -of your configurations are upgraded yet, we recommend that you use the -official release `.zip` files instead of the APT packages, so you can install -multiple versions at once and then select which to use for each command you -run. - -### Terraform 1.4.3 and Later - -As of Terraform 1.4.3, all published packages include a revision number by -default, starting with `-1`. This change means that in the case that we need -to publish an updated package for any reason, installers can automatically -retrieve the latest revision. You can learn more about this packaging change -in [the announcement](https://discuss.hashicorp.com/t/linux-packaging-debian-revision-change/42403). - -You can install the latest revision for a particular version by including the -version in the `apt install` command, as follows: - -```bash -sudo apt install terraform=1.4.4-* -``` - -### Terraform 1.4.2 and Earlier - -Terraform 1.4.2 and earlier did not include a revision number for the first -revision, so you can use the following pattern to install a specific version: - -```bash -sudo apt install terraform=1.4.0 -``` diff --git a/website/docs/cli/install/yum.mdx b/website/docs/cli/install/yum.mdx deleted file mode 100644 index 11c8ce2a53..0000000000 --- a/website/docs/cli/install/yum.mdx +++ /dev/null @@ -1,120 +0,0 @@ ---- -page_title: Install Terraform using yum packages for Linux distributions -description: >- - Learn how to install Terraform using HashiCorp yum packages for Red Hat Enterprise Linux (RHEL), Fedora, CentOS, and Amazon Linux systems. ---- - -# Install Terraform Using Yum Packages for Linux Distributions - -The primary distribution packages for Terraform are `.zip` archives containing -single executable files that you can extract anywhere on your system. However, -for easier integration with configuration management tools and other systematic -system configuration strategies, we also offer package repositories for -RedHat Enterprise Linux, Fedora, and Amazon Linux systems, which allow you to -install Terraform using the `yum install` or `dnf install` commands. - -If you are instead using Debian or Ubuntu, you -might prefer to [install Terraform from our APT repositories](/terraform/cli/install/apt). - --> **Note:** The Yum repositories discussed on this page are generic HashiCorp -repositories that contain packages for a variety of different HashiCorp -products, rather than just Terraform. Adding these repositories to your -system will, by default, therefore make a number of other non-Terraform -packages available for installation. That might then mask the packages that are -available for some HashiCorp products in the main distribution repositories. - -## Repository Configuration - -Before adding a repository you must determine which distribution you are using. -The following command lines refer to a placeholder variable `$release` which -you must replace with the appropriate value from the following list: - -* Red Hat Enterprise Linux: `RHEL` -* Fedora: `fedora` -* Amazon Linux: `AmazonLinux` - -If you are using a Yum-based distribution, add the repository using -`yum-config-manager` as follows: - -```bash -sudo yum install -y yum-utils -sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/$release/hashicorp.repo -``` - -If you are using a DNF-based distribution, add the repository using -`dnf config-manager` as follows: - -```bash -sudo dnf install -y dnf-plugins-core -sudo dnf config-manager addrepo --from-repofile=https://rpm.releases.hashicorp.com/$release/hashicorp.repo -``` - -In both cases, the Terraform package name is `terraform`. For example: - -```bash -yum install terraform -``` - -## Supported Architectures - -The HashiCorp Yum/DNF server has packages only for the `x86_64` -architecture, which is also sometimes known as `amd64`. - -There are no official packages available for other architectures, such as -`aarch64`. If you wish to use Terraform on a non-`x86_64` system, -[download a normal release `.zip` file](/terraform/downloads) instead. - -## Supported Distribution Releases - -The HashiCorp Yum server contains release repositories for the -following distribution releases: - -* AmazonLinux 2 and "latest" -* Fedora 33 -* Fedora 34 -* Fedora 35 -* Fedora 36 -* Fedora 37 -* RHEL 7 (and CentOS 7) -* RHEL 8 (and CentOS 8) -* RHEL 9 (and CentOS 9) - -No repositories are available for other versions of these distributions or for -any other RPM-based Linux distributions. If you add the repository using -the above commands on other systems then you will see a 404 Not Found error. - -Over time we will change the set of supported distributions, including both -adding support for new releases and ceasing to publish new Terraform versions -under older releases. - -## Choosing Terraform Versions - -The HashiCorp Yum repositories contain multiple versions of Terraform, but -because the packages are all named `terraform` it is impossible to install -more than one version at a time, and `yum install` or `dnf install` will -default to selecting the latest version. - -It's often necessary to match your Terraform version with what a particular -configuration is currently expecting. Use the following command to -retrieve the available versions in the repository index: - -```bash -yum --showduplicate list terraform -``` - -You can select a specific version to install by including it in the -`yum install` command line, as follows: - -```bash -yum install terraform-0.14.0-2.x86_64 -``` - -If you are using a DNF-based distribution, similar use `dnf` instead of `yum` -when following the above steps. - -If your workflow requires using multiple versions of Terraform at the same -time, for example when working through a gradual upgrade where not all -of your configurations are upgraded yet, we recommend that you use the -official release `.zip` files instead of the Yum packages, so you can install -multiple versions at once and then select which to use for each command you -run.