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:
ping <gateway address> # is the host reachable
telnet <gateway address> 8085 # is the port open
systemctl status neuronex # is the service runningIn production, change the default password and create read-only accounts as needed — see User Management.
Routine checks
| What to watch | Where |
|---|---|
| Node link states, collection and forwarding volume, rule status | Operation Monitoring |
| Automatic notification of driver disconnects, rule failures, and instance restarts | Monitoring and Alert Management |
| Tags failing to collect | Data Monitoring and Device Control |
| Disk usage and log rotation | Log Management |
Upgrades and backups
- Take a backup first — see Backup and Restore.
- An upgrade does not overwrite
/opt/neuronex/data. For package upgrades see Install from a Package · Upgrading; for containers see Deploy with Docker. - After upgrading, confirm that southbound and northbound nodes return to Running and Connected, and that rules are healthy.
Troubleshooting
| Symptom | Where to look |
|---|---|
| No data from a device | Diagnosing a connection, then the read error counters in Operation Monitoring |
| Data is not being forwarded | Confirm the northbound application is running and the subscription exists — see Subscribe to Southbound Data · Verify |
| A rule produces no output | Rule testing |
| Filing a support ticket | Download the logs — see Log Management |
Configuration and permissions
- System Configuration: data processing engine, log level, third-party sign-in, tracing, backup and restore
- Startup Parameters and Configuration Files: command line, environment variables, configuration files, HTTPS
- Data Directory and Persistence: directory layout and mounting
- User Management: accounts, roles, 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.