How to upgrade Terraform Enterprise(Replicated Installation) via command line – HashiCorp Help Center

Introduction

This guide provides instructions for upgrading a Replicated installation of Terraform Enterprise (TFE) to a newer version using the command line. This method is useful for programmatic or automated upgrade processes.

Prerequisites

You have SSH access to the Terraform Enterprise instance.
The replicatedctl command-line utility is installed and configured.
You have administrative privileges on the instance.

Procedure

There are two methods for upgrading, depending on whether your TFE instance is online or airgapped.

Method 1: Online Upgrade

Fetch all available TFE release versions.

$ replicatedctl app-release ls --fetch --all

Apply the latest available update.
```
$ replicatedctl app-release apply
```
Alternatively, to upgrade to a specific version, use the --sequence flag with the desired release number. You can find release sequence numbers in the Terraform Enterprise Release Sequence Versions article.
```
$ replicatedctl app-release apply --sequence 570
```

Method 2: Airgapped Upgrade

Ensure your .airgap release files are in the correct directory on the TFE instance. You can find the configured path in the Replicated Admin Console at https://<TFE_HOSTNAME>:8800/console/settings under the Update Path field. You can also retrieve this path from the command line.
```
$ replicatedctl params export --template '{{.AirgapPackagePath}}'
```
After placing the .airgap files in the directory, rescan for available releases.
```
$ replicatedctl app-release ls --fetch
```
Apply the latest available update from the scanned files.
```
$ replicatedctl app-release apply
```
Alternatively, to upgrade to a specific version, use the --sequence flag with the desired release number. You can find release sequence numbers in the Terraform Enterprise Release Sequence Versions article.
```
$ replicatedctl app-release apply --sequence 570
```

Additional Information

For details on monitoring the upgrade process, refer to How To Track The Progress of a Terraform Enterprise Update via Replicated CLI.