About the Syncro Linux Agent

The Syncro Linux Agent operates as a native systemd service, providing persistent monitoring and centralized management of Linux endpoints within the Syncro platform. This tool connects your Linux assets directly to standard RMM workflows through the following capabilities:

• Remote Troubleshooting: Resolve service failures using one-click Splashtop access for GUI environments or background CLI tools for direct terminal access. This enables tasks such as editing configuration files, managing user permissions, or troubleshooting network latency directly from Syncro.
• Automated Health Remediation: Link system-level Bash scripts to monitors to automate maintenance. For example, a disk usage monitor can automatically trigger a script to clear temporary files and generate a follow-up ticket when thresholds are exceeded.
• Fleet-Wide Patching: Execute system-wide updates and security patches across your fleet using the Scripting Module. This allows you to bulk-update kernel versions, enforce security configurations (like SSH hardening), or deploy critical vulnerability fixes without manual intervention.
• Custom Alerting and Ticketing: Use native Syncro Bash commands within scripts to trigger platform alerts or create support tickets. You can automate tickets for failed backup jobs, unauthorized login attempts detected in auth logs, or application-specific errors unique to your environment.
• Standardized Deployment and Reporting: Deploy at scale using silent installation scripts. Once installed, Linux assets automatically synchronize system health and hardware specifications, appearing in unified reports alongside Windows and Mac endpoints.

Syncro's Linux Agent supports RHEL and Ubuntu LTS across multiple architectures. See our Supported Versions document for specifics.

Prerequisites

The Syncro Linux Agent will automatically install these libraries if they are not already present on the system:

• .NET Runtime 8 installed from the official Microsoft repository,
• dmidecode used to read hardware details like CPU, memory, BIOS, and other system information
• fuse or libfuse2/libfuse2t64 needed for file system mounting support, and
• yum-utils on RHEL systems to check if a reboot is required.

Install the Syncro Linux Agent

To install the Linux agent, you'll need to download the correct installer package for your device's architecture and execute it via the command line. Follow these steps:

1. In Syncro, navigate to the Organizations tab.
2. Click a customer organization's Name/Business to open the Organization Details Page.
3. Select RMM Agent Installer from the +New button menu:
   
4. Select a Policy Folder containing the policy you'd like to attach to the installer. By default, the top-level Policy Folder is selected.
5. Select the appropriate Linux installer package:
   
   • Select “Linux - x64 (RUN)” for standard 64-bit Intel/AMD systems.
   • Select “Linux - arm64 (RUN)” for newer ARM-based systems.
     Tip: If you're not sure which to use, run uname -m on your Linux device. x86_64 requires the x64 installer, while aarch64 requires the arm64 version.
6. Click Copy Link.
   Notes: 
   • Installer links remain active for 7 days.
   • Get RMM Installer generates a .RUN file, which bypasses the need for Step 7a. You'll still need to do Steps 7b and c below.
7. For headless or server environments, download and execute the installer via the command line:
   1. To ensure the file is named correctly and redirects are followed, use one of the following commands:
      1. curl -L -OJ “PASTE_COPIED_LINK_HERE”
      2. wget --content-disposition “PASTE_COPIED_LINK_HERE”
         IMPORTANT: Always use the -L -OJ flags for curl or --content-disposition for wget to ensure the installer is named correctly.
   2. Before running, grant execution permissions to the script: chmod +x SyncroInstaller-Linux-x64.run
   3. Run the Installer with root privileges, e.g.: sudo ./SyncroInstaller-Linux-x64.run

The installer automatically registers the Syncro Linux agent as a native systemd service. This ensures the agent reliably starts on boot and restarts upon failure.

Tip: You can manage the Syncro Agent using standard Linux service commands. For example, to check the agent's current status, use: sudo systemctl status syncro

Core Actions and Asset Control

The Syncro Linux Agent provides Technicians with the following up-to-date information about the Linux asset:

• Its online status, so you can quickly determine if the device is currently connected and responsive to commands.
• Complete system information (hardware, OS details, etc.) directly on the Syncro Portal asset page. This data is collected and automatically synced with the platform by the agent.

Technicians can also execute the following remote actions from the Assets & RMM table and individual Asset Detail pages:

• Reboot Device: Initiates a graceful system restart.
• Sync Assets Data: Forces the agent to immediately collect and send all system inventory and diagnostic data.
• Maintenance: Places the device into a Maintenance Mode for a specific duration, which suppresses all alerts and notifications on the platform.
• Delete Device: When you delete the asset from the platform, the agent automatically detects this status and executes its self-uninstall routine.
• Archive: Transitions the asset into an inactive state. Historical data (tickets/alerts) is preserved, but the platform sends an Uninstall Command to the agent. The agent will self-remove during its next check-in.
• Merge: Combines a duplicate or retired Linux asset into the desired, active asset. All ticket history is moved, and the agent on the duplicate device is automatically uninstalled to prevent duplicate reporting.

Scripting with the Linux Agent

The Syncro Linux Agent supports running Bash shell scripts with System-level permissions. It includes a Script module that allows you to interact directly with the Syncro platform using commands for alerts and activities, asset and ticket management.

Alerts & Activities

• Rmm-Alert -Category 'Name' -Body ‘Msg’
• Close-Rmm-Alert -Category 'Name' -CloseAlertTicket “true”
• Log-Activity -Message "Msg" -EventName "Name"

Asset Management

• Set-Asset-Field -Name "Field" -Value “Value”
• Upload-File -FilePath “/path/to/file”
• Send-Email -To "email" -Subject "Sub" -Body "Msg"

Ticket Management

• Create-Syncro-Ticket -Subject "Sub" -IssueType "Type" -Status “New”
• Update-Syncro-Ticket -TicketIdOrNumber 123 -Status “Open”
• Create-Syncro-Ticket-Comment -TicketIdOrNumber 123 -Body "Msg" -Hidden “true”
• Create-Syncro-Ticket-TimerEntry -TicketIdOrNumber 123 -DurationMinutes 30 -Notes “Work”

CLI Support

The agent provides command-line access on the Linux device for direct control. 

Run syncro help to view the list of all available syncro commands:

The syncro version command is the only command that does not require additional options to run. To see the available options for a command, add the --help flag. For example, if you enter: 

syncro sync --help, you may receive:

-t, --type    Required.

This means it's required that you specify the 'type' of sync, such as:

syncro sync -t large OR syncro sync --type large

Only the syncro uninstall command requires admin rights (sudo). For example:

sudo syncro uninstall OR sudo syncro uninstall --force

Note: The commands listed in Scripting with the Linux Agent are also supported in the CLI.

Troubleshooting

If you're having trouble with the Syncro Linux Agent installation or use, here are some troubleshooting tips:

• Verify that you've used the -L -OJ flags for curl or --content-disposition for wget to ensure the installer is named correctly.
• Verify that you've selected the right installer. Run uname -m on your Linux device. (x86_64 requires the x64 installer, while aarch64 requires the arm64 version.)

On some non-standard distributions, the automatic .NET 8 installation may fail. If this occurs, manually install the .NET Runtime 8 from the official Microsoft repository before running the Syncro installer.

While Syncro officially supports RHEL and Ubuntu, partners have reported success on other RHEL-based and Debian-based distributions. However, results may vary on these platforms.