Skip to content

Operations ​

This section is for the administrators and operators who maintain EMQX Neuron day to day, organized by operational task.

Signing in to the console ​

Open http://<gateway address>:8085 in a browser and sign in with the default account admin / 0000. The port can be changed in the startup parameters — see Startup Parameters and Configuration Files.

If the page does not open, check in order:

bash
ping <gateway address>            # is the host reachable
telnet <gateway address> 8085     # is the port open
systemctl status neuronex         # is the service running

In production, change the default password and create read-only accounts as needed — see User Management.

Routine checks ​

What to watchWhere
Node link states, collection and forwarding volume, rule statusOperation Monitoring
Automatic notification of driver disconnects, rule failures, and instance restartsMonitoring and Alert Management
Tags failing to collectData Monitoring and Device Control
Disk usage and log rotationLog Management

Upgrades and backups ​

  1. Take a backup first — see Backup and Restore.
  2. An upgrade does not overwrite /opt/neuronex/data. For package upgrades see Install from a Package · Upgrading; for containers see Deploy with Docker.
  3. After upgrading, confirm that southbound and northbound nodes return to Running and Connected, and that rules are healthy.

Troubleshooting ​

SymptomWhere to look
No data from a deviceDiagnosing a connection, then the read error counters in Operation Monitoring
Data is not being forwardedConfirm the northbound application is running and the subscription exists — see Subscribe to Southbound Data · Verify
A rule produces no outputRule testing
Filing a support ticketDownload the logs — see Log Management

Configuration and permissions ​

High availability ​

Two instances form a master-backup pair through Keepalived, with the virtual IP failing over automatically when the master goes down. See Master-Backup Mode.

Further reading ​

For API calls, error codes, measured performance figures, and common questions, see Reference and Support. For end-to-end walkthroughs of specific scenarios, see Tutorials and Best Practices.