NeuroWall

Add your license to NeuroWall

Step-by-step instructions to activate a NeuroWall license key on an appliance and check that it worked.

Updated 2026-11-10

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 refresh to recover.
  • Moving to other hardware. Run neurowall-cli license deactivate on 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 seeLikely cause and fix
license operation requires an API URL and admin tokenLog in first with neurowall-cli login, or set NEUROWALL_API.
Activation fails with a connection or TLS errorThe 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 startslicense.server_url is empty or does not start with https://. Fix it and restart neurowall.
invalid credentialsThe key was mistyped. Copy it exactly as issued.
activation limit reachedThe key is already active on as many appliances as you licensed nodes. Deactivate one, or add nodes.
Errors that mention time or proofsThe 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).