User-Facing Deployment Instructions
These are the exact steps a Linux admin needs:
Step 1 — Download and extract
cd /tmpcurl -fsSL https://app.rmmmax.com/files/rmmmax_linux_agent_1.0.0.tar.gz \ -o rmmmax_linux_agent.tar.gz
tar -xzf rmmmax_linux_agent.tar.gz
cd rmmmax_linux_agent
Step 2 — Run the installer (requires root/sudo)
sudo bash install.sh
The installer will:
Detect your distro (Ubuntu/Debian/RHEL/Rocky/Fedora) automatically
Install Python 3 if missing
Create /var/rmmmax/agentservice/
Install the rmmmax-agent command
Register the service to start automatically on every reboot
Step 3 — Register the agent
sudo rmmmax-agent register
You’ll be prompted for:
RMMMax username (your login email)
RMMMax password
Client name (e.g. Acme Corp — or press Enter for Unassigned)
Location name (e.g. HQ Office — optional)
Or pass everything non-interactively (useful for scripted deployments):
sudo rmmmax-agent register \ –username admin@example.com \ –password “yourpassword” \ –client-name “Acme Corp” \ –location-name “HQ Office”
Step 4 — Start the service
sudo systemctl start rmmmax-agent
sudo systemctl status rmmmax-agent
The service is already enabled — it will start automatically after every reboot.
Day-2 Management Commands
Check status and recent logs
rmmmax-agent status
# View live service logs
journalctl -u rmmmax-agent -f
# Update client or location name
sudo rmmmax-agent update –client-name “New Client” –location-name “Branch 2”
sudo systemctl restart rmmmax-agent
# Recover a lost token (e.g. after restoring from backup)
sudo rmmmax-agent reregister
# Uninstall
sudo rmmmax-agent deregister
sudo systemctl disable –now rmmmax-agent
sudo rm -f /etc/systemd/system/rmmmax-agent.service /usr/local/bin/rmmmax-agent
sudo rm -rf /var/rmmmax/agentservice
Supported Distros
Distro Tested
Ubuntu 20.04 / 22.04 / 24.04 ✓
Debian 11 / 12 ✓
Linux Mint 21+ ✓
RHEL 8 / 9 ✓
Rocky Linux 8 / 9 ✓
AlmaLinux 8 / 9 ✓
Fedora 38+ ✓
CentOS Stream 8 / 9 ✓
System requirement: Python 3.6 or later (pre-installed on all modern distros; installer auto-installs if missing). No other dependencies.