Skip to main content
All CollectionsMonarx Agent & ProtectInstallation
CentOS 8 / AlmaLinux 8 / Rocky Linux 8 / CloudLinux 8
CentOS 8 / AlmaLinux 8 / Rocky Linux 8 / CloudLinux 8

Installation of Monarx Agent & Protect PHP extension

Will avatar
Written by Will
Updated over a week ago

This article shows a basic installation of the Monarx Agent. For advanced configuration, including using regex patterns in scan bases and quarantine directories, see Advanced Agent Configuration.

Monarx uses RPM packages managed via yum for CentOS 8 and similar distributions.

Set up the repo

sudo curl -o /etc/yum.repos.d/monarx.repo https://repository.monarx.com/repository/monarx-yum/linux/yum/el/8/x86_64/monarx.repo

Import Our GPG Key

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

Set up the Agent configuration file

During initial account setup the web app will prompt you to download your agent configuration file with your Enterprise's client_id and client_secret populated. Following initial installation configuration files can be provisioned in the Credentials Module in the Monarx web app (monarx-agent.conf). Place the file in your servers' /etc/ directory: /etc/monarx-agent.conf. You may re-use the credentials/configuration file created, alternatively you can provision more in the future.

Before installing the Agent & Protect modules 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.

Install the Agent and Protect packages with yum

sudo yum 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 Agent is running and communicating with the cloud successfully by navigating to the Agents module in the Monarx web app.

Did this answer your question?