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
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
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
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)
Yum (CentOS / RHEL / CloudLinux / Alma / Rocky)
sudo yum install monarx-protect-autodetect
Apt (Ubuntu / Debian)
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)
Yum (CentOS / RHEL / CloudLinux / Alma / Rocky)
sudo yum install monarx-agent-auditd
Apt (Ubuntu / Debian)
Apt (Ubuntu / Debian)
sudo apt-get install monarx-agent-auditd