Platforms

How do you monitor a server managed by Ploi?

Add server monitoring to a Ploi-managed server: install the Opservo agent with a Ploi script running as root, or over SSH. Requirements and what you see.

In short

Ploi provisions servers and deploys sites, but it does not explain why a server is slow, filling up or exposed. Install the Opservo agent once per server, either with a Ploi script that runs as root (Scripts are on Ploi’s paid plans) or over SSH. It takes about a minute and changes nothing in Ploi.

What do you need?

  • •A Ploi-managed server with systemd (amd64 or arm64)
  • •An Opservo workspace; Free covers up to 2 servers
  • •Outbound HTTPS (port 443) to api.getopservo.com. Opservo opens no inbound port

How do you install it?

  • •In Opservo, click Add a new server, then Generate install command. The token in it works once and expires after one hour
  • •In Ploi, create a script, set its user to root, paste the command and run it on one server
  • •Or over SSH: log in as ploi, run sudo su with the sudo password Ploi emailed you, and paste the command
  • •Generate a fresh command for each further server, because each token is single-use
curl -sSL https://api.getopservo.com/install.sh | sudo env OPSERVO_API_URL=https://api.getopservo.com OPSERVO_TOKEN=<token> bash

For a batch, a reusable fleet key lets one script run enrol many servers. Fleet-enrolled servers are treated as disposable: one offline for 30 minutes is archived automatically instead of raising an offline alert, so prefer one-time tokens for long-lived servers.

What do you see afterwards?

Each server gets a 0–100 health score and findings with the command that fixes them: CPU, memory, disk and load; systemd services such as nginx, PHP-FPM, MySQL and Redis; Docker containers; listening ports; security checks; kernel-log errors; and laravel.log for sites in /home/ploi/<site>. Domains and SSL expiry are read from the standard nginx config folders. For any site the agent does not list, add an uptime monitor, which checks it from outside and tracks the certificate.

Last updated 2026-10-10.

FAQ

Related questions

Does it change anything in Ploi?+

No. The agent is a separate systemd service. It is read-only by default and never reads .env files.

Can Opservo run fixes on the server?+

Only if you opt the server in with OPSERVO_ENABLE_ACTIONS=true on the box, on a paid plan. Every command is confirmed and audited.

How do you remove it?+

Run curl -sSL https://api.getopservo.com/install.sh | sudo env OPSERVO_UNINSTALL=1 bash, then remove or archive the server in the fleet table.