Installation

Requirements

Linux (amd64 or arm64)
Network access to api.moniqo.io

Quick install

curl -s https://moniqo.sh/install | sudo bash -s -- --org-id <your-org-id>

Service user

By default the agent runs as a dedicated system user moniqo, not as root. The installer creates the user, grants the systemd unit a minimal set of Linux capabilities (CAP_SYSLOG, CAP_DAC_READ_SEARCH, CAP_SYS_PTRACE) and writes a narrow sudoers whitelist (/etc/sudoers.d/moniqo-agent) that only allows the storage-health CLIs (smartctl, ssacli, storcli) and restarting the agent service after a self-update.

Installer options:

Option	Meaning
`--user root`	Run the agent as root (legacy behavior, no sudoers file needed)
`--user <name>`	Run under a custom system user
`--docker`	Add the service user to the `docker` group (container monitoring; note that docker group membership is root-equivalent)
`--no-docker`	Never ask about the docker group

If Docker is installed and neither --docker nor --no-docker is given, the installer asks interactively. Without a terminal it skips the docker group and container monitoring stays off.

Re-running the installer keeps the user the service already runs as unless you pass --user explicitly. If you install RAID CLI tools later, re-run the installer to refresh the sudoers whitelist.

Manual install

Download the binary for your architecture from the Downloads page
Place it in /usr/local/bin/moniqo-agent
Create the config file at /etc/moniqo/agent.conf:

api_endpoint=https://api.moniqo.io
api_token=YOUR_TOKEN_HERE

Start the agent:

/usr/local/bin/moniqo-agent --config /etc/moniqo/agent.conf

Systemd service

Create /etc/systemd/system/moniqo-agent.service:

[Unit]
Description=Moniqo Agent
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/moniqo-agent --config /etc/moniqo/agent.conf
Restart=always
RestartSec=30

[Install]
WantedBy=multi-user.target

Then enable and start:

systemctl enable moniqo-agent
systemctl start moniqo-agent