Introduction
Problem
During the installation of Terraform Enterprise with replicated, it doesn't start or become available. The replicated admin console shows the following
Executing the command replicatedctl app status
shows the following error :
replicatedctl app status
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 on replicated
Cause
The issue is likely to be related to an expired license however, it could be masked under a network issue.
Solutions
Option 1:
Verify the license expiration date, This can be performed through either the Replicated console UI or the Replicated command line interface.
Replicated Console
- Access the Replicated console at https://<<TFE_HOSTNAME>>:8800
- Click the gear icon (top-right) → View License
-
- The expiration date is displayed under ExpirationTime.
Command Line
- SSH into the TFE host machine
- Run:
replicatedctl license inspect
- Locate the ExpirationTime field (UTC format).
If the license is up to date, you may want to consider checking option 2; otherwise, please follow the steps outlined in our documentation to update your Terraform Enterprise license for online installation and Airgap installation types.
Option 2:
Past observations show that network-related problems, such as Docker image pull failures, may manifest as license errors. When license validity is confirmed, yet errors continue, consult the troubleshooting steps outlined in this Knowledge Base article.
Outcome
Terraform Enterprise will be up and running after resolving the issue using the steps above.