Airgapped install of Terraform Enterprise fails to start up with 'License bootstrap failed: install license online: online installation in airgapped mode'

Introduction

This article provides a solution for a license bootstrap failure that can occur during an airgapped installation of Terraform Enterprise.

Problem

When you attempt to install Terraform Enterprise in an airgapped environment, the installation fails with the following error message:

License bootstrap failed: install license online: online installation in airgapped mode

Cause

This error occurs because the Terraform Enterprise installer attempts to perform an online license installation, even in airgapped mode. This happens when the path to the .airgap package, which contains the license, is not correctly specified in the installer's configuration file.

Solution

To resolve this issue, you must explicitly define the path to your .airgap package in the Replicated configuration file.

1. Open the Replicated configuration file, located at /etc/replicated.conf, in a text editor.

2. Verify that the LicenseBootstrapAirgapPackagePath setting points to the correct and full path of your .airgap file. For example:

   {
     "LicenseBootstrapAirgapPackagePath": "/path/to/your/license.airgap"
   }

3. Save your changes to the /etc/replicated.conf file.
4. Re-run the Terraform Enterprise installation script. The installer should now locate the airgap package and proceed with the offline installation.

Additional Information

• For detailed instructions on airgapped installations, please refer to the official Terraform Enterprise documentation.