Skip to main content

​
Adding a Server

​
Step 1: Get Your Token

Go to catops.app/settings and copy your Agent Token.

​
Step 2: Install Agent

Run on your server:
Don’t use sudo. The agent installs to your home directory (~/.local/bin).

​
Step 3: Connect to Cloud

​
Step 4: Start as Service

Your server will now appear in the dashboard.

​
What Gets Collected

Every 10-30 seconds (configurable), the agent collects:

​
Changing Collection Interval

Valid range: 10-300 seconds.

​
Multiple Servers

Repeat the install process on each server. They’ll all appear in your dashboard.
Free tier: up to 3 servers. PRO: unlimited.

​
Naming Servers

Servers are named by their hostname by default. To change:
  1. Go to Settings in the dashboard
  2. Find the server
  3. Click Edit and set a custom name

​
Removing a Server

On the server:
Then remove it from the dashboard in Settings → Servers.

​
Troubleshooting

  1. Check connection: catops auth info
  2. Restart service: catops restart
  3. Check logs: catops service status
  1. Ensure service is running: catops service status
  2. Check network: curl https://api.catops.app/health
  3. Restart: catops restart
The agent typically uses less than 1% CPU. If higher:
  1. Increase interval: catops set interval 60
  2. Restart: catops restart