Skip to content
⌘K

How to activate and refresh your Business plan license key

Updated by Denis

When you buy the self-hosted Business plan or start its free trial, we email you a license key. It looks like this: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. You can use the same key on as many instances as you like, for example production, staging and development. Usage from all of them counts towards your plan's allowance.

Can't find the email? See I didn't receive my Business plan license key.

Activate the key in n8n

  1. Sign in to n8n as the instance owner or an admin.

  2. Go to Settings > Usage and plan. In n8n 2.46 and later, this page is called Plan & usage.

  3. Click Enter activation key, paste your key and click Activate.

  4. When you see License activated, restart n8n. If you run queue mode, restart the main instance and all the workers.

  5. Open Settings > Usage and plan again. It should now say you're on the Business plan.

You can also activate the key with the N8N_LICENSE_ACTIVATION_KEY environment variable, which is handy for Docker and Kubernetes. n8n only uses it when the instance has no license yet. If the instance already has one, for example a free Community Edition key, n8n skips the variable and keeps the existing license, so activate the key in Settings instead. Don't set N8N_LICENSE_CERT as well, because it overrides your key.

Keep your license renewing

Your instance renews its license with our license server at license.n8n.io automatically, about once a day. Each renewal also reports your production execution count. You don't need to do anything, as long as:

  • The main n8n instance can reach license.n8n.io over HTTPS. In queue mode, workers don't need access. The license server sits behind Cloudflare, so if your firewall allowlists by IP address, allow Cloudflare's IP ranges. If you use a proxy, set https_proxy_license_server; if it isn't set, n8n uses https_proxy.

  • N8N_LICENSE_AUTO_RENEW_ENABLED isn't set to false.

If your instance can't renew, Business features stop working about four days after the last successful renewal. They come back once the instance can renew again.

Refresh your license

Your key stays the same when your plan renews or you change tier. Your instance picks up the change at its next daily renewal.

To renew straight away, open Settings > Usage and plan as the owner or an admin. Opening the page renews the license. Restarting n8n doesn't force a renewal.

To see the details of the license on your instance, run n8n license:info. With Docker, run docker exec -u node -it <container> n8n license:info. It shows when the current license certificate expires and the dates your plan is valid between.

Move your license to a new server

Activate the same key on the new instance. Then shut down the old instance or run n8n license:clear on it, so it stops reporting usage against your plan.

When your subscription ends

When your subscription ends, the license stops renewing and your instance goes back to the Community edition. Business features stop working. If you store binary data in S3 or Azure, change N8N_DEFAULT_BINARY_DATA_MODE before your subscription ends, because n8n won't start with S3 or Azure binary storage without a valid license.

Activation errors

Activation key is in the wrong format

The key wasn't pasted in full, or extra characters came with it. Copy it again from the email.

Activation key not found

The key has a typo, or it isn't a Business plan key. Copy it again from the email. If it still fails, contact us.

Activation key has expired

A key can only be activated on new instances for a limited time after we issue it. Instances that already use the key keep working. Contact us and we'll let you activate it again.

Activation key has been used too many times

The key has reached its activation limit. Contact us.

Activation key has already been used on this instance

This instance has already activated this key. Restart n8n and open Settings > Usage and plan. If it still doesn't show the Business plan, contact us. Don't run n8n license:clear unless we ask you to, because you'd have to activate the key again, and that fails if the key can no longer be activated on new instances.

Failed to activate license, followed by a network error

Your instance can't reach license.n8n.io. Check your firewall and proxy settings, as described above.

Still need help?

Email us at help@n8n.io. Include the exact error message, the output of n8n license:info, your n8n version, and how you run n8n (for example Docker, Kubernetes or queue mode). Leave your license key out of screenshots and logs you share publicly.

For more detail, see Manage your license in the n8n docs.