Offline License Activation

In air-gapped systems or corporate environments where direct access to authentication providers (like Microsoft and GitHub) or to DBCode servers is restricted, you can use the offline license activation process.

Overview

The offline license activation process involves the following steps:

  1. Generate a machine key on the air-gapped or restricted machine
  2. Use that machine key on a connected machine to generate a license
  3. Install the license on the air-gapped machine

Flow Diagram

Offline License Activation Flow Diagram
Overview of the Offline License Activation Process

Step-by-Step Instructions

Step 1: Generate Key (on the air-gapped machine)

  1. Open Visual Studio Code
  2. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
  3. Type and select DBCode: Generate Key for License
  4. A key will be displayed in a dialog box
  5. Copy this key to a text file or other portable medium

Step 2: Generate a License (on a connected machine)

  1. Open Visual Studio Code
  2. Make sure you are signed in to your DBCode account.
  3. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
  4. Type and select DBCode: Generate License from Key
  5. Enter the key that you copied from the air-gapped machine
  6. A license will be generated and displayed
  7. Copy this license to a text file or other portable medium

Step 3: Install the License (on the air-gapped machine)

  1. Open Visual Studio Code
  2. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
  3. Type and select DBCode: Install License
  4. Enter the license that you copied from the connected machine
  5. If successful, you will see a confirmation message that the license has been installed

Troubleshooting

Invalid License

If you receive an “Invalid License” error:

  • Verify that you’ve copied the entire license without any missing characters
  • Check that the machine key used to generate the license matches the current machine
  • Ensure your subscription is active

Expired License

Manual licenses are tied to your subscription period. If your subscription expires, you’ll need to:

  1. Renew your subscription
  2. Generate a new license
  3. Apply the new license on the air-gapped machine

Machine Key Changes

If your machine’s hardware configuration changes significantly, a new machine key might be generated. In this case:

  1. Generate the new machine key
  2. Create a new license using this machine key
  3. Apply the new license

License Management

  • Each license is valid for a single machine
  • The number of offline licenses you can generate is limited to one every 30 days