Skip to main content

​
Overview

This guide explains how to install, verify, manage, and remove the AirMDR Remote Agent on a Linux system.

​
Pre-requisites

Ensure the following requirements are met before installation:
  • Operating System: Linux
  • Architecture: amd64
  • Privileges: Root or sudo access
  • Service Manager: systemd
  • Network Access: Outbound connectivity to the AirMDR backend (as configured in config.json)
    The Remote Agent does not require inbound network access.

​
Installation Procedure

1

Transfer the Installation Package

  1. Copy the downloaded Remote Agent ZIP package to the target Linux machine.
    Example using SCP:
  2. You may also use:
    • SFTP or secure file transfer tools
    • Direct download on the target machine
  3. Login to target Linux machine.
2

Extract the Package

  • Unzip the package and move into the extracted directory:
3

Verify Package Contents

Confirm that the required files are present:
  • Agent binary:
    airmdr-remote-agent-v*-linux-amd64 (or airmdr-remote-agent)
  • Configuration file:
    config.json
  • Installation script:
    scripts/install.sh
Verify using:
4

Run the Installation Script

Run the installer with root privileges:
What the Installer DoesThe installation script performs the following actions:
  1. Copies the agent binary to:
  2. Copies config.json to:
  3. Creates a systemd service:
  4. Enables and starts the service automatically
5

Verification - Confirm Agent Status

Verify that the Remote Agent service is running:
Expected status:
6

View Agent Logs (Optional)

To monitor agent logs in real time:
Press Ctrl + C to exit.

​
Service Management

Use the following commands to manage the Remote Agent service:

​
Start the Agent

​
Stop the Agent

​
Restart the Agent

​
Enable Auto-Start on Boot

​
Disable Auto-Start on Boot

​
Troubleshooting

​
Agent Fails to Start

If the service does not start, inspect recent logs:

​
Common Causes

  • Missing config.json:
    Ensure the file exists at /opt/airmdr-remote-agent/config.json
  • Invalid configuration values:
    Verify required fields such as server_url
  • Network connectivity issues:
    Confirm the AirMDR backend is reachable
  • Permission issues:
    Ensure the binary is executable

​
Reinstallation

To reinstall the Remote Agent:
  1. Stop and disable the service:
  2. Remove existing files:
  3. Re-run the installation steps starting from Run the Installation Script.

​
Uninstallation

To completely remove the AirMDR Remote Agent:

​
Support

For additional assistance: