Installing or uninstalling the Linux Agent

PERMISSIONS  Administrator

NAVIGATION  Devices > All > Add Device > enter a Managed site name > select a Managed site > Linux

NAVIGATION  Sites > All Sites > click the name of a Managed site > Add Device > Linux

Linux Agents run on the Mono framework, the open source version of .NET for UNIX O/S.

IMPORTANT  For information about supported Linux versions, refer to Supported operating systems and Agent requirements. For information about which services get installed, refer to Services, dependencies, and folders (Windows, macOS, Linux).

How to...

  • To download the Datto RMM Agent installer, refer to the steps outlined in Downloading the Agent or sharing the Agent installer. The Linux Agent setup file will have a .sh extension (for example, AgentSetup_Managed.sh).

    • NOTE  Linux devices can only be added to Managed sites.

    NOTE  If a previous version of MONO is already installed on the device, it may have to be removed prior to re-installation by the Agent.

    Once you have downloaded the Datto RMM Agent installer for Linux, follow the steps below to install the Datto RMM Agent.

    1. Open your Terminal app.
    2. Change the directory to the folder that contains the .sh file:
      3. cd[folder containing the Datto RMM .sh file]
    3. To make the file executable, type the following:
      4. sudo chmod +x [file name].sh
    4. Enter your password when prompted.
    5. Type the following:
      6. sudo sh [file name].sh
    6. The Agent will be installed.
    7. Close the terminal window when you are able to type text into the window again.

    The device should now appear in Datto RMM.

    NOTE  For information about manually enrolling other types of devices, refer to Adding a device.

    Complete the following steps to install the Agent on a Linux device via the Terminal:

    1. Choose the type of Mono that should be installed on the device.
    2. Open your Terminal app and type the following to download the Agent:
    					sudo wget [the web address of the Linux Agent from your site] -O agent.sh

    NOTE   In order to retrieve the web address of the Agent, complete the first step in the preceding section and choose to copy the Agent link.

    1. Once the Agent has been downloaded, type the following:
    					sudo sh [the path and file name of the Agent]
    1. Alternatively, to both download and install the Agent, type the following:
    					sudo wget -O setup.sh [the web address of the Linux Agent from your site] && sudo sh setup.sh
    1. The Datto RMM Agent will now be installed.

    IMPORTANT  If you are uninstalling the Linux Agent from Red Hat, ensure that your username is included on the sudoers list. If it is not, please see this guide.

    IMPORTANT  If you are running other tools or applications that use Mono, note that Mono is removed during this uninstallation process.

    To uninstall the Agent on a Linux device, complete the following steps according to which operating system you are using:

    To uninstall the Agent on a Red Hat-based operating system, open your Terminal app and type the following:

    							sudo chmod +x /opt/CentraStage/uninstall.sh
								sudo /opt/CentraStage/uninstall.sh 
								sudo rm -fr /opt/CentraStage 
								sudo rm -fr /usr/local/share/CentraStage 
								sudo rm -fr /root/.local/share/CentraStage 
						sudo yum remove mono-runtime

    To ensure the system is up to date, type the following:

    						sudo yum -y update && sudo yum -y upgrade

    To download and install a fresh copy of the Datto RMM Agent, type the following:

    							wget -O agent.sh "URL" 
								chmod +x agent.sh 
						sudo ./agent.sh

    To uninstall the Agent on a Debian-based operating system, open your Terminal app and type the following:

    							sudo chmod +x /opt/CentraStage/uninstall.sh 
								sudo /opt/CentraStage/uninstall.sh
								sudo rm -fr /opt/CentraStage 
								sudo rm -fr /usr/local/share/CentraStage 
								sudo rm -fr /root/.local/share/CentraStage 
						sudo apt-get purge mono-runtime

    To ensure the system is up to date, type the following:

    						sudo apt-get -y update && sudo apt-get -y upgrade

    To download and install a fresh copy of the Datto RMM Agent, type the following:

    							wget -O agent.sh "URL" 
								chmod +x agent.sh 
						sudo ./agent.sh