Introduction
This guide provides the steps for uninstalling a Terraform Enterprise instance that uses the Replicated deployment option.
Expected Outcome
After following this guide, your Terraform Enterprise (Replicated) instance will be uninstalled from the host machine.
Prerequisites
- A host machine with an active Terraform Enterprise (Replicated) installation.
- Access to the host machine with appropriate user permissions to stop services and run scripts.
Use Case
This procedure is for decommissioning a Terraform Enterprise (Replicated) deployment or for resolving a broken or corrupted installation where creating a new instance is not a viable option.
Procedure
1. Back Up Application Configuration
Before uninstalling, back up your application configuration for reference. Certain critical information, such as the encryption password, is required if you plan to reinstall and connect to existing data. Without the matching password, Terraform Enterprise cannot access information stored in the PostgreSQL database or in object storage.
Export the configuration by running the following command.
$ replicatedctl app-config export --hidden
2. Stop the Terraform Enterprise Application
Stop the application from the Replicated console (port 8800) or by using the command line.
$ replicatedctl app stop
Verify that the application has stopped. This process stops and removes the Docker containers running the Terraform Enterprise application and may take a few minutes to complete.
$ replicatedctl app status
The output should show the State as stopped.
3. Stop Replicated Services
After the Terraform Enterprise application has stopped, stop the associated Replicated services.
$ systemctl stop replicated replicated-ui replicated-operator
4. Run the Uninstall Script
To complete the process, download and run the official uninstall script. Follow the detailed steps in the Uninstall Terraform Enterprise documentation.