Problem
When installing or migrating to Terraform Enterprise with Flexible Deployment Options (FDO), pulling the required Docker images fails with an authentication error.
First, you may attempt to log in to the Docker registry using your license key.
$ cat license.txt | docker login --username terraform images.releases.hashicorp.com --password-stdin
However, the subsequent pull command fails with the following error.
# sudo docker pull images.releases.hashicorp.com/hashicorp/terraform-enterprise:xxxx-x
Error Message:
Error response from daemon: Head "https://images.releases.hashicorp.com/v2/hashicorp/terraform-enterprise/manifests/latest": no basic auth credentials
Cause
This error typically occurs for one of the following reasons:
- The license key provided is incorrect, expired, or not valid for FDO installations.
- There is confusion between a license for a Replicated-based installation and a license for an FDO installation.
Solutions
Solution 1: Verify the License Type
Confirm that you are using a Flexible Deployment Option (FDO) license and not a Replicated license (.rli) to pull the Docker images. An FDO license is a long alphanumeric string.
Example of an FDO license format:
02MV4UU43BK5HGYYTOJZWFQMTMNNEWU33JJVCGWMCOIRATAWLKKF2E6VDHGFHHSMBUJVKEC6CMKRBG2TL2JF2E6RCZGVHDESTJLFLUU3KOK5MXOSLJO5UVSM2WPJSE.......
Solution 2: Request a New License
If you have confirmed you are using a valid FDO license and the error persists, your license may have expired. In this case, please contact your HashiCorp account team to request a new FDO license.
Outcome
After using a valid and current FDO license, you should be able to successfully pull the Docker images required for the Terraform Enterprise installation.
Additional Information
- For more details on the installation process, please refer to the Flexible Deployment Options installation documentation.