Self-hosted n8n has a free upgrade that’s easy to miss: register your Community Edition with an email address, and n8n sends you a free license key. This guide shows how to get the free n8n Community Edition license key and activate it.
By the end, your n8n’s Plan & usage page says You’re on the Community Edition · Registered, and three extra features are unlocked for good:
- Folders, to organise your workflows in nested folders.
- Advanced debugging, to fix a failed run and run it again (n8n’s docs call it debug in editor (opens in a new tab)).
- Execution search and tagging, to save and search details of past runs (custom execution data (opens in a new tab)).
Cost: free. Registering doesn’t start a trial or a paid plan; n8n’s dialog says “once unlocked, you’ll keep them forever”.
Every screen on this page is real, from n8n 2 running in Docker on macOS.
Prerequisites
- A self-hosted n8n you can sign in to as its owner or an admin, the roles n8n’s docs (opens in a new tab) name for adding a license key.
- An email address you can read now: the key arrives by email.
Step 1: Open Plan & usage
In n8n, click Settings at the bottom of the left menu, then Plan & usage under Billing, near the end of the list.

The page says You’re on the Community Edition, with a yellow Unlock box. Click Unlock.

Step 2: Ask n8n for the Key
The dialog lists what the key unlocks. The email box starts with your n8n account’s address; change it if you read mail somewhere else. Click Send me a free license key.

n8n confirms with Your license key is on the way!
Step 3: Find the License Email
Look for an email from n8n titled Your free n8n license key to unlock selected paid features. It holds your key under Your license key, plus an Activate License Key button. The email says you have 14 days to activate it.

Tip: treat the key like a password. Don’t paste it into public posts or shared screenshots.
Step 4: Enter the Activation Key
Copy the key from the email. Back on Plan & usage, click Enter activation key on the right.

Paste the key into Activation key and click Activate. (The email’s Activate License Key button is the other way n8n’s docs (opens in a new tab) describe.)

n8n shows License activated and asks you to restart it. Click Close.

Step 5: Restart n8n
If you installed n8n with n8n’s one-line setup, run these two commands in Terminal from the folder that holds the n8n folder. The first stops n8n; the second starts it again.
docker compose -f ./n8n/compose.yml down
docker compose -f ./n8n/compose.yml up -d
Give n8n a few seconds, then reload Plan & usage. If the page shows Cannot GET, n8n is still starting: wait and reload again.
Step 6: Check It’s Registered
Plan & usage now says You’re on the Community Edition with a Registered badge, and the Unlock box is gone.

Common Mistakes
| Mistake | What happens | Do this instead |
|---|---|---|
| Leaving an address you can’t read in the email box | The key goes to that address | Type the email you want the key sent to |
| Waiting more than 14 days | The email gives 14 days to activate the license | Activate it as soon as the email arrives |
| Skipping the restart | n8n asks for a restart to make all licensed features available | Stop and start n8n (Step 5) |
Troubleshooting
| Problem | Cause | Fix |
|---|---|---|
| The email doesn’t arrive | It can land in spam, or the address had a typo | Check spam, then open Unlock again and check the address |
Cannot GET after the restart | n8n is still starting | Wait a few seconds and reload |
FAQ
Is the n8n Community Edition license key really free?
Yes. n8n calls this edition the Registered Community Edition (opens in a new tab): the free Community Edition with extra features unlocked by registering your email.
Do I need a license key to use n8n?
No. The Community Edition works without one. The key only adds folders, advanced debugging, and execution search and tagging.
Can I register when I first set up n8n?
Yes. A new n8n offers the same dialog right after you create the owner account. If you skipped it then, these steps work at any time.
Where do I enter a paid plan’s license key?
In the same place: Settings › Plan & usage › Enter activation key. n8n’s Manage your license (opens in a new tab) page also shows how to set a key with an environment variable.
Conclusion
Registering takes an email and one key: ask for it under Plan & usage, paste it into Enter activation key, and restart n8n. Your Community Edition is now registered, with folders, advanced debugging and execution search unlocked at no cost.
Additional Resources
- Compare editions (opens in a new tab) (n8n docs)
- Manage your license (opens in a new tab) (n8n docs)
- n8n pricing (opens in a new tab)
Related
- How to Install n8n with Docker
- n8n Tutorial — Part 1: What Is n8n? Workflow Automation Explained
- Is n8n Free for Commercial Use? The n8n License Explained
n8n and other names mentioned are trademarks of their respective owners. JD Bots isn’t affiliated with or endorsed by n8n GmbH.
0 comments