Tactical RMM for Linux

LinuxRMM-Script Setup

Install, update, and remove Tactical RMM Linux agents with MeshCentral details, Tactical RMM API values, and the correct client/site IDs.

View repositoryInstallation wiki

Quick Start

1

Download

Fetch the latest script directly from the LinuxRMM-Script repository.

2

Make executable

Set execute permissions before running install, update, or uninstall commands.

3

Install agent

Run the installer with MeshCentral, Tactical RMM, client, site, and auth values.

wget https://raw.githubusercontent.com/Nerdy-Technician/LinuxRMM-Script/refs/heads/main/rmmagent-linux.sh
sudo chmod +x rmmagent-linux.sh

Required Values

Mesh Agent URLFrom MeshCentral Add Agent for Linux/BSD/macOS. Copy the base URL without install flags.

API URLYour Tactical RMM API endpoint, usually something like https://api.example.com.

Client IDVisible in Tactical RMM when hovering over the client name.

Site IDVisible in Tactical RMM when hovering over the site name.

Auth KeyGenerated from the manual Windows agent install flow. Copy the value after --auth.

Agent TypeUse server or workstation.

Install The Agent

./rmmagent-linux.sh install 'Mesh Agent URL' 'API URL' ClientID SiteID 'Auth Key' 'Agent Type'

Example:

./rmmagent-linux.sh install 'https://mesh.example.com/meshagents?id=XXXXX' 'https://api.example.com' 3 1 'XXXXX' server

Compilation can take several minutes depending on the device hardware.

Cleaner Output

Use --simple when you want less noisy install output.

sudo bash rmmagent-linux.sh --simple install 'Mesh Agent URL' 'API URL' ClientID SiteID 'Auth Key' 'Agent Type'

Readable progressClear informational, success, and error messages.

Less clutterDownload and compile progress is collapsed into easier-to-scan output.

Cleanup visibilityTemporary file cleanup is shown clearly at the end of the run.

Architecture Detection

The script detects the system architecture with uname -m and maps it to the correct agent type.

x86_64amd64

i386 / i686x86

aarch64arm64

armv7larmv6

armv6larmv6

If the architecture is not recognized, the script exits safely with an error.

Update Or Uninstall

Update an agent

./rmmagent-linux.sh update

Remove an agent

./rmmagent-linux.sh uninstall 'Mesh FQDN' 'Mesh ID'

Use uninstall only when removal from Tactical RMM is not working. This does not remove records from the Tactical RMM or MeshCentral dashboards; clean those up manually if needed.

Ubuntu Blank Screen Fix

Ubuntu workstations using Wayland may show a blank MeshCentral remote desktop session. Switch GDM back to X11:

sudo sed -i '/WaylandEnable/s/^#//g' /etc/gdm3/custom.conf
sudo systemctl restart gdm

On Ubuntu 19 and earlier, the config path is /etc/gdm/custom.conf.

Credits

LinuxRMM-Script builds on Netvolt's LinuxRMM-Script with extended compatibility, cleaner output, and production-focused refinements.