License Activation

Self-hosted NocoDB requires a valid license key to enable paid features. The activation method depends on whether your server has internet access. If you do not have a license yet, see Purchase a License.

Which method should I use?

Most self-hosted customers use Standard. If your environment restricts outbound connections, use Airgapped. If your server can never connect to the internet, reach out to us and we will set it up for you.

Standard license

Best for cloud VMs, typical data centers, and any environment with internet access.

How to activate

1. Open the NocoDB UI and go to Admin Panel > License.

   

2. Paste your license key into the Enter your license key field. The Save button activates once a key is entered.

   

3. Click Save. NocoDB validates the key against NocoDB Cloud. On success, the status banner turns green and paid features are activated immediately — no restart needed.

   

How it stays active

NocoDB periodically checks in with the license server (a lightweight call — no application data leaves your server). If your server temporarily loses internet, there is a 7-day grace period before paid features are paused. Connectivity restored? Everything resumes automatically.

Airgapped license

Best for firewalled environments, restricted networks, or anywhere ongoing internet access is not possible.

With an airgapped license, NocoDB connects to the internet once during setup. After that single activation, it runs fully offline for the lifetime of the license — no check-ins, no callbacks.

How to activate

1. You will receive a license key starting with nc_ag_ from NocoDB.

2. Make sure your server has temporary outbound internet access (just for the initial activation).

3. Open the NocoDB UI and go to Admin Panel > License.

4. Paste your nc_ag_ license key and click Save.

5. NocoDB activates the license with a single outbound call. Once confirmed, you can remove internet access — NocoDB will continue running with full paid features.

Good to know

• After activation, no internet connection is needed until the license expires.
• The license is tied to your installation. If your Instance ID changes, contact us to re-activate.

Offline activation

For environments that can never connect to the internet — classified networks, isolated infrastructure, or strict compliance setups.

We handle this for you. Here's what to do:

1. Start NocoDB. During startup, it prints an Instance ID in the logs:

   docker compose logs nocodb | grep "Instance ID"

   You will see something like:

   Instance ID: a1b2c3d4e5f6789...

2. Send us your Instance ID along with your license key by emailing cs@nocodb.com.

3. We will send you back a license token. Open the NocoDB UI, go to Admin Panel > License, paste the token, and click Save.

Manage license on this instance

Once a license is active, the Admin Panel → License page exposes additional controls.

Refresh license

Click Refresh License to re-validate the license against NocoDB Cloud. Use this if your plan was recently upgraded or renewed and the instance has not yet picked up the change.

Remove license

Click Remove License to deactivate the license on this instance. You will be asked to confirm. After removal, the instance reverts to Community Edition mode and paid features are disabled. The license key remains available in your NocoDB Cloud account and can be re-applied at any time.

Manage License (billing portal)

Once a license is active, a Manage License card appears on the License page. Click it to open the Stripe billing portal — see Manage Billing for what you can do there.

What is the Instance ID?

The Instance ID uniquely identifies your NocoDB deployment. It is printed in the server logs every time NocoDB starts and remains stable across restarts, updates, and reboots. If it ever changes, reach out to us for a new activation.

Renewing your license

Troubleshooting