Problem
During a Replicated-based installation, Terraform Enterprise does not start or become available. The Replicated admin console displays an error.
Executing the replicatedctl app status command shows the following error message.
Error: App not found. It is possible that you have not yet uploaded a license. Please first install a license using the license-load command.
Prerequisites
- Terraform Enterprise (Replicated deployment)
Cause
This error typically indicates an expired license, but it can also be a symptom of an underlying network issue, such as a failure to pull Docker images.
Solutions
Solution 1: Verify License Validity
Verify the license expiration date using either the Replicated admin console or the command-line interface.
Replicated Admin Console
- Access the Replicated admin console at
https://<TFE_HOSTNAME>:8800. - Click the gear icon in the top-right corner and select View License.
- Check the date displayed under ExpirationTime.
Command Line
- SSH into the Terraform Enterprise host machine.
-
Run the following command to inspect the license details.
# replicatedctl license inspect
- Locate the
ExpirationTimefield, which is in UTC format.
If the license has expired, follow the documentation to update your Terraform Enterprise license for online or airgapped installations. If the license is valid, proceed to the next solution.
Solution 2: Investigate Network Issues
Network-related problems, such as Docker image pull failures, can sometimes manifest as license errors. If you have confirmed the license is valid but the error persists, consult the troubleshooting steps for Docker image pull failures.
Outcome
After you resolve the underlying license or network issue, Terraform Enterprise will start successfully and become available.