> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/system-administration/requesting-an-airgap-license.md). # Requesting an Airgap License How to request an airgap license for VergeOS systems with no outbound Internet access, and how to upload the license file you receive from Verge.io. {% hint style="warning" %} **Air-gap licensing is not common and requires justification. Please see** [**Licensing and Software Updates**](/run-the-platform/system-administration/licensing-and-updates.md) **for more information.** {% endhint %} ## Overview {% hint style="info" %} **Key Points** * VergeOS requires a valid license for operation * Air-gapped environments need a special airgap license * The process involves generating a license request file and emailing it to Verge.io * Verge.io returns a license file, which you upload on the **System > Settings** page {% endhint %} This guide shows how to request an airgap license for VergeOS systems without outbound Internet access, and how to upload the license file you receive. ## Prerequisites * Access to the VergeOS Cloud Dashboard * A working email client on a machine that can send external emails * Understanding of your system's airgapped status ## Requesting the License **From the system you intend to license:** 1. Navigate to System Settings * Select **System** from the top menu and then select **Settings**. 2. Initiate License Request * On the left menu, click **Request Offline License** * The **Request Generated** dialog opens and shows the name and size of the license request file 3. Download Request File * Click the **Download Request File** button * Save the license request file to your local machine 4. Prepare Email to Verge.io * Click the **** link in the dialog * This opens your default email client with a pre-addressed email 5. Send License Request * Attach the downloaded license request file to the email * Provide additional information in the email body (e.g., company name, purpose of license) * Send the email to the Verge.io licensing team ## What Happens Next 1. Verge.io processes your request and generates an airgap license file 2. You receive a reply email with the airgap license file attached 3. Upload the license file to your VergeOS system (see [Uploading the License](#uploading-the-license)) {% hint style="info" %} **Processing Time** If you haven't received a response within 2 business days, please follow up with the VergeOS support team. {% endhint %} ## Uploading the License When you receive the license file from Verge.io, upload it to the system: 1. Navigate to **System > Settings**. 2. On the left menu, click **Add License**. The **New License** form opens. * If the system already has a license, the menu shows **Edit License** instead. Click it to replace the installed key. 3. Below the **License Key** field, click **Choose File** and select the license file you received. * The file contents fill the **License Key** field. * You can also open the license file in a text editor and paste its contents into the **License Key** field. 4. (Optional) Enter a **Note**, such as the request date or ticket number. 5. Click **Submit**. The **License** section of the Settings page shows the new license and its validity dates. ## Important Considerations * Ensure the system requesting the license is the one you intend to license * Keep the license request file secure * For multiple systems, repeat this process for each system individually ## Troubleshooting {% hint style="warning" %} **Common Issues** * Problem: Unable to generate license request file * Solution: Verify your access permissions in the VergeOS Cloud Dashboard * Problem: Email client doesn't open automatically * Solution: Manually compose an email to and attach the downloaded request file * Problem: The license key is rejected when you submit the form * Solution: Make sure the **License Key** field contains the complete, unmodified contents of the license file {% endhint %} ## Additional Resources * [Updating a VergeOS System with Airgap License](/knowledge-base/system-administration/updating-vergeos-system-with-airgap-license.md) * [Licensing and Software Updates](/run-the-platform/system-administration/licensing-and-updates.md) ## Feedback {% hint style="info" %} **Need Help?** If you encounter any issues while requesting an airgap license or have questions about this process, please don't hesitate to contact our support team. {% endhint %} *** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/knowledge-base/system-administration/requesting-an-airgap-license.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.