Support & documentation

Install NEURU on your server.

NEURU is 100% self-hosted — it runs on your hardware, on your network. Deploy it with Docker in minutes, then activate your license against this portal.

Requirements

A Linux server (Ubuntu 22.04+ recommended) with Docker & Docker Compose. 2 vCPU / 4 GB RAM is plenty to start. Outbound HTTPS to this portal for activation.

Get the installer

Log in to your account → Downloads → grab the latest NEURU build your plan entitles you to. Verify the SHA-256.

Your license key

Find it on your Dashboard (click to copy). One key activates the machines your plan allows.

Configuration Guide — connect your tools
Step-by-step for Pi-hole, Portainer, n8n, Graylog/syslog, Grafana Alloy, SMTP & more — including which key goes where.
Open guide
Step by step

Deploy in 5 steps

1

Download & extract

From Downloads, get neuru-installer-vX.tar.gz, copy it to your server, and unpack:

tar xzf neuru-installer-vX.Y.Z.tar.gz cd neuru-installer
2

Create the shared network & start

NEURU uses an external Docker network, then Compose brings up the app + database:

# one time docker network create neuru-net docker compose up -d --build
3

Run the setup wizard

Open http://YOUR-SERVER:8090 → the first-run wizard imports the schema and creates your admin. Default login is admin / [email protected] — change it immediately under your profile.

4

Point NEURU at this portal & activate

In NEURU → Site Configuration → Licensing: set the License portal API URL to https://neurunetpr.com/api.php, paste your license key, and click Activate. NEURU binds to the machine and receives a signed token.

5

Add your devices & go

Run discovery or add nodes in Config, then explore the Command Deck. Updates appear in NEURU's Licensing panel and here under Downloads.

Good to know

Your license never bricks your NOC

  • Offline grace.Can't reach the portal? NEURU keeps running on its cached token for 14 days, with a quiet banner.
  • Soft node limits.Over your node count? You get a warning + email — never an automatic shutdown.
  • Moving servers?Deactivate the old machine from your license page to free the slot, then activate the new one.
  • Air-gapped?Enterprise & Perpetual can run fully offline with a signed .lic file — contact us for one.
Common commands
# view logs docker compose logs -f web # restart docker compose restart web # update to a new build docker compose down tar xzf neuru-installer-vNEW.tar.gz docker compose up -d --build
Staying up to date

Updating NEURU

Every NEURU release is a complete build — the same package you install with. To update, you simply deploy a newer build over the old one. Your data is safe: all your nodes, history, settings and users live in the database volume, which is never touched by an update.

The easy way (recommended)

1. Check for a new version.

In NEURU → Site Configuration → Licensing you'll see when a newer build is available. New builds also appear here under Downloads.

2. Back up first (30 seconds).

A quick safety net before any update:

docker exec neuru-mysql mysqldump -usisuser -psispass netmon > neuru-backup.sql
3. Download the new build.

From Downloads — or pull it straight onto the server with the wget/curl command shown there (authenticated by your license key, logged to your history).

4. Swap the app & restart.

This replaces only the program files — your database is untouched:

cd neuru-installer docker compose down # unpack the new build over this folder tar xzf ~/neuru-installer-vNEW.tar.gz --strip-components=1 docker compose up -d --build
5. Done.

Open NEURU — the version in About shows the new number. Any schema changes apply automatically on first load.

What's preserved on update

  • All your datanodes, metrics history, incidents, settings, users — it lives in the MySQL volume, not the app files.
  • Your licensethe activation stays bound to the machine; no re-activation needed.
  • Your integrationsSMTP, n8n, Pi-hole, etc. keep their settings.
Prefer not to touch a terminal? Your reseller/IT partner can run these steps, or contact us — we'll walk you through it or do it for you.

Stable vs. Beta

Downloads may show stable builds (recommended for production) and, when available, beta builds (early features, marked with a badge). Stick to stable unless we ask you to test a beta.

The activation says "invalid key"
Double-check you copied the whole key from your Dashboard (click it to copy), that the portal API URL ends in /api.php, and that your server can reach the portal over HTTPS.
"activation_limit_reached"
You've used all the machine slots on this license. Deactivate a machine you no longer use from your license page, or upgrade your plan for more activations.
Which port does NEURU use?
The portal is on :8090 by default (plus 514/udp syslog and 2055/udp NetFlow). Put a TLS reverse proxy in front for production.
Do I need internet on the NEURU server?
Only outbound HTTPS to this portal for activation + periodic revalidation. For fully isolated networks, ask us about an offline .lic file.

Still stuck?

We're here to help you get NEURU running.

Go to your dashboard