Platforms

How do you monitor a server managed by Coolify?

Add host-level monitoring to a Coolify server: install the Opservo agent from Coolify’s terminal or over SSH, on the host rather than as a container.

In short

Coolify deploys your apps as Docker containers; Opservo explains what is happening on the host underneath them. Install the Opservo agent on the host, not as a container: open the server’s Terminal in Coolify, or SSH in, and run one command. It takes about 30 seconds and opens no inbound port.

What do you need?

  • •A server connected to Coolify, running Linux with systemd (amd64 or arm64)
  • •Owner or Admin role in the Coolify team and Terminal Access enabled for the server, or SSH
  • •An Opservo workspace; Free covers up to 2 servers
  • •Outbound HTTPS (port 443) to api.getopservo.com

How do you install it from Coolify’s terminal?

In Opservo, click Add a new server, then Generate install command. The token in it works once and expires after one hour. In Coolify, open Terminal, start a session on the server and paste the command. The session runs as the SSH user Coolify uses for that server, which is root by default; a non-root Coolify user has passwordless sudo, so the command works either way.

curl -sSL https://api.getopservo.com/install.sh | sudo env OPSERVO_API_URL=https://api.getopservo.com OPSERVO_TOKEN=<token> bash

Why on the host and not as a Coolify resource?

The agent is a systemd service that reads host facts: disks, the kernel log, systemd units and the Docker daemon. Inside a container it would only see that container.

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; every Docker container with its live CPU and memory, restart count and logs; listening ports, including database ports published to the internet; security checks; and kernel-log errors. Coolify routes traffic through its own proxy container, so add an uptime monitor for each public app; it checks the app from outside and tracks its SSL certificate.

Last updated 2026-10-10.

FAQ

Related questions

Does it change anything in Coolify?+

No. The agent is a separate systemd service on the host. 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.