Skip to main content

Monarx Installation

Installing Monarx Packages

J
Written by James Martin
Updated over 3 weeks ago

Supported Operating Systems

Distro

Version

CentOS / RHEL / CloudLinux

6, 7, 8, 9

Ubuntu

16, 18, 20, 22, 23, 24

Debian

9, 10, 11, 12

Alma / Rocky

8, 9

Please contact us if you're using an OS variant that you isn't detailed above.

Tip: Monarx is API first and supports Unattended Agent Installations.

Install the Monarx Agent

The Monarx agent is the workhorse that coordinates security measures such as file system scanning, malicious process monitoring, malicious cron file activity, and more through to coordinating with the Monarx Cloud.

1. Set up the Agent configuration file
During initial account setup the web app will prompt you to download your agent configuration file, which contains your client_id and client_secret.

Alternatively, new credentials and configuration files can be provisioned in the Credentials Module in the Monarx web app. Select the βž• symbol ➜ New Agent Credential ➜ Save which offers an option to Download the full agent configuration file.

Place this configuration file in /etc/monarx-agent.conf.

Before installing the Agent package below, uncomment/configure the user_base values in the monarx-agent.conf file according to the examples provided, or as described in Advanced Agent Configuration.

2. Add the Monarx Repository

To install any Monarx package, add the Monarx repository to your package manager:

CentOS / RHEL / CloudLinux / Alma / Rocky

curl -fsS https://repository.monarx.com/repository/monarx-yum/monarx.repo | sudo tee /etc/yum.repos.d/monarx.repo

sudo rpm --import https://repository.monarx.com/repository/monarx/publickey/monarxpub.gpg

Ubuntu

curl -fsS https://repository.monarx.com/repository/monarx/publickey/monarxpub.gpg | sudo tee /etc/apt/trusted.gpg.d/monarx.asc

echo "deb [arch=amd64] https://repository.monarx.com/repository/ubuntu-$(lsb_release -sc)/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/monarx.list

Debian

curl -fsS https://repository.monarx.com/repository/monarx/publickey/monarxpub.gpg | sudo tee /etc/apt/trusted.gpg.d/monarx.asc

echo "deb [arch=amd64] https://repository.monarx.com/repository/debian-$(lsb_release -sc)/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/monarx.list

Tip: Have a staging environment or anywhere you want the cutting edge? Configure out pre-release repo here.

3. Install the Agent and Protect

Install the monarx-protect-autodetect package with your preferred package manager:

For standard apache, litespeed, cPanel, Plesk style environments, the php extension can be automatically installed with:

Yum (CentOS / RHEL / CloudLinux / Alma / Rocky)

sudo yum install monarx-protect-autodetect

Apt (Ubuntu / Debian)

sudo apt-get update
sudo apt-get install monarx-protect-autodetect

The monarx-protect-autodetect package pulls in the monarx-agent and monarx-protect packages as dependencies. It configures Protect to be loaded as a PHP extension for common configurations of PHP, although you may need to restart your web servers for the changes to take effect.

You can verify that the Protect module is loaded and running via php -m | grep monarxprotect. Alternatively navigate to the Agents module in the Monarx web app, select the Agent then select Extensions where loaded and active PHP modules will be displayed.

For bespoke webserver installations, please see our Advanced Protect Installation guide.

Optional: Install Auditd Integration

An optional but recommended auditd integration is available for systems which support auditd. This enables near realtime processing of filesystem activity, providing the lowest malware time-to-detection and time-to-remediation.

Yum (CentOS / RHEL / CloudLinux / Alma / Rocky)

sudo yum install monarx-agent-auditd

Apt (Ubuntu / Debian)

sudo apt-get install monarx-agent-auditd

Did this answer your question?