Add your license to NeuroWall
Step-by-step instructions to activate a NeuroWall license key on an appliance and check that it worked.
Follow these steps on the appliance that runs NeuroWall. They apply to a license key you received after purchase or from our team. Run the neurowall-cli commands on the appliance itself.
1. Check the network and the clock
The appliance must reach the license server over HTTPS and its clock must be correct.
- NeuroWall refuses a license server address that does not start with
https://. - The proof the appliance sends is checked against the server's clock. Keep the appliance within five minutes of correct time (use NTP).
- Set the server address in
/etc/neurowall/config.yaml, with no trailing path, then restart the service:
license:
server_url: https://your-license-server.example.com
sudo systemctl restart neurowall
If you do not know the license server address for your account, ask your administrator or contact us.
2. Have your license key ready
Your key is shown once, when it is issued, and it is sent to your email. Copy it into a file that only you can read, for example /tmp/license.key. We store only a fingerprint of the key and cannot show it again. If you lose it, ask us for a replacement; the old key is then revoked.
3. Activate
Log in to the NeuroWall CLI with your NeuroWall administrator account, then activate:
neurowall-cli login
neurowall-cli license activate /tmp/license.key
shred -u /tmp/license.key
The appliance registers itself with the server, receives a signed entitlement, verifies it and stores it locally. The last command removes the key file securely.
4. Check that it worked
neurowall-cli license status
You should see State: ACTIVE and the edition you purchased. Features and limits of that edition are now available. Compare editions on the pricing page.
5. What to expect afterwards
- Refresh. The appliance refreshes its entitlement on its own. To refresh now, run
neurowall-cli license refresh. Changes to your subscription, such as a new edition or more nodes, are picked up on the next refresh. - If the license server is unreachable. The appliance keeps its last verified entitlement and stays active. If it cannot refresh for a long time it enters a network-grace period (14 days by design) before it falls back to the free Community floor. Reconnect and run
neurowall-cli license refreshto recover. - Moving to other hardware. Run
neurowall-cli license deactivateon the old appliance. This releases its activation and returns it to the Community floor. Then activate the new appliance with the same key.
6. Troubleshooting
| What you see | Likely cause and fix |
|---|---|
license operation requires an API URL and admin token | Log in first with neurowall-cli login, or set NEUROWALL_API. |
| Activation fails with a connection or TLS error | The appliance cannot reach the server, or does not trust its certificate. From the appliance, check https://<server>/v1/health with curl. |
| The refresh loop never starts | license.server_url is empty or does not start with https://. Fix it and restart neurowall. |
invalid credentials | The key was mistyped. Copy it exactly as issued. |
activation limit reached | The key is already active on as many appliances as you licensed nodes. Deactivate one, or add nodes. |
| Errors that mention time or proofs | The appliance clock is more than five minutes off. Fix NTP. |
If you still cannot activate, contact us with the time of the attempt and the first characters of your key (never the whole key).