RMON
- How to set up your Time zone
- How to create a Telegram bot and use it with RMON
- How to create a Slack APP and use it with RMON
- How to create PagerDuty Integration key and use it with RMON
- Notifications and alerting
- Status pages
- Security checklist
- Company sign-in with OIDC
- Get started with the RMON API
- Backup and recovery
- How to use groups and roles
- How to change user settings
Servers
How to add a new server
A server record tells RMON how to reach an agent host over SSH. Adding the record makes the host available for agent installation.
Before you begin
Choose the owning group and prepare an SSH account with non-interactive sudo access. Save its SSH credentials. The host must be reachable from RMON, including when RMON runs in Docker.
Add the host
- Switch to the intended group, then open Admin area → Servers and click Add.
- Fill in the following fields. Use your actual host address in place of the documentation example.
Scroll horizontally to view the full table.
| Field | Example | Meaning |
|---|---|---|
| Name | monitor-london | A recognizable label for this host. |
| IP | 192.0.2.13 | The IP address or hostname that RMON can reach over SSH. |
| Port | 22 | The host's SSH port. The agent management port is selected during agent installation. |
| Credentials | Production monitoring hosts | The saved credential containing the host username and key/password. |
| Group | Production | The host owner, when the selector is available to your role. |
| Enable | Enabled | Make the host available for use in RMON. |
| Description | Monitoring from the London office | Optional context for other administrators. |
- Save the form and find the new row.
- Open Actions (⋮) → Check SSH. If it fails, use the error table before installing.
- Open Agents → Add Agent, select this server, and follow agent installation.
Expected result: the server appears in the list, Check SSH succeeds, and it is available for a new agent. A host with an existing agent will not be offered for installing a second one.
Use the RMON host itself
You can name this record localhost. In the IP field, use the host address reachable from the RMON container and authorize SSH on that host. The address 127.0.0.1 inside a container identifies that container.
Change access or retire the host
When SSH access changes, edit the server's port or credential, save, and repeat Check SSH. If the host address changes, also review the agent address, result receiver addresses and certificate names affected by the move. Verify a new monitoring result after the change.
Cloning creates another server record; supply its own name and address. Before deleting a server, transfer the required monitoring work to another agent and remove the agent associated with this host. Keep configuration and backups until replacement monitoring is confirmed.