Script for one-line installation and updating of the tacticalRMM agent
Scripts are now available for x64, x86, arm64, and armv6. However, only x64 and i386 have been tested on Debian 11 and Debian 10 on bare metal, VMs (Proxmox), and VPS (OVH). Tested on raspberry 2B+ with armv7l (chose armv6 on install)
Scripts for other platforms will be available later as I adapt the script to other platforms. Feel free to adapt the script and submit changes to me!
Download script with this url: https://raw.githubusercontent.com/netvolt/LinuxRMM-Script/main/rmmagent-linux.sh
For Ubuntu systems try: 'wget https://raw.githubusercontent.com/netvolt/LinuxRMM-Script/main/rmmagent-linux.sh' Make executable after downloading with: 'sudo chmod +x rmmagent-linux.sh'
Ubuntu uses the Wayland display manager instead of the regular X11 server. This causes MeshCentral to show a blank screen, preventing login, viewing, or controlling the client. Using the command lines below should solve the problem:
sudo sed -i '/WaylandEnable/s/^#//g' /etc/gdm3/custom.conf
sudo systemctl restart gdm
This will cause your screen to go blank for a second. You will be able to use remote desktop afterwards.
If you encounter a 'file not found' error, you are likely using Ubuntu 19 or earlier. On these machines, the config file will be located on /etc/gdm/custom.conf. Modify the command above accordingly. < Please note that remote desktop features are only installed when you used the workstation agent. You may need to reinstall your mesh agent.
To install the agent, launch the script with this argument:
./rmmagent-linux.sh install 'System type' 'Mesh agent' 'API URL' 'Client ID' 'Site ID' 'Auth Key' 'Agent Type'The compiling can be quite long, don't panic and wait few minutes... USE THE 'SINGLE QUOTES' IN ALL FIELDS!
The arguments are:
- System type
Type of system. Can be 'amd64' 'x86' 'arm64' 'armv6'
- Mesh agent
The url given by mesh for installing new agent. Go to mesh.fqdn.com > Add agent > Installation Executable Linux / BSD / macOS > Select the good system type Copy ONLY the URL with the quote.
- API URL
Your api URL for agent communication usually https://api.fqdn.com.
- Client ID
The ID of the client in wich agent will be added. Can be viewed by hovering over the name of the client in the dashboard.
- Site ID
The ID of the site in wich agent will be added. Can be viewed by hovering over the name of the site in the dashboard.
- Auth Key
Authentification key given by dashboard by going to dashboard > Agents > Install agent (Windows) > Select manual and show Copy ONLY the key after --auth.
- Agent Type
Can be server or workstation and define the type of agent.
./rmmagent-linux.sh install 'amd64' 'https://mesh.fqdn.com/meshagents?id=XXXXX&installflags=X&meshinstall=X' 'https://api.fqdn.com' 3 1 'XXXXX' serverSimply launch the script with update as argument.
./rmmagent-linux.sh updateTo uninstall the agent, launch the script with this argument:
./rmmagent-linux.sh uninstall 'Mesh FQDN' 'Mesh ID'Note: Single quotes must be around the Mesh ID for it to uninstall the mesh agent properly
The argument are:
- Mesh FQDN
Example of FQDN: mesh.fqdn.com
- Mesh ID
The ID given by mesh for installing new agent. Go to mesh.fqdn.com > Add agent > Linux / BSD (Uninstall) > Copy ONLY the last value with the single quotes. You are looking for a 64-character long value consisting of a random mix of letter cases, numbers, and special characters.
./rmmagent-linux.sh uninstall mesh.fqdn.com 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'- You should only attempt this if the agent removal feature on TacticalRMM is not working.
- Running uninstall will not remove the connections from the TacticalRMM and MeshCentral Dashboard. You will need to manually remove them. It only forcefully removes the agents from your linux box.