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: 
curl -fsSL https://get.catops.app/install.sh | bash
Don’t use sudo. The agent installs to your home directory (~/.local/bin).

​
Step 3: Connect to Cloud

catops auth login YOUR_TOKEN

​
Step 4: Start as Service

catops service install
catops service start
Your server will now appear in the dashboard.

​
What Gets Collected

Every 10-30 seconds (configurable), the agent collects:
MetricDescription
CPUUsage percentage, per-core breakdown
MemoryUsed, available, cached, swap
DiskUsage per mount, IOPS, throughput
NetworkBytes in/out, connections, errors
ProcessesTop processes by CPU and memory
ServicesDetected services (nginx, postgres, etc.)
Load1m, 5m, 15m load averages

​
Changing Collection Interval

catops set interval 30
catops restart
Valid range: 10-300 seconds.

​
Multiple Servers

Repeat the install process on each server. They’ll all appear in your dashboard. 
# On server 2
curl -fsSL https://get.catops.app/install.sh | bash
catops auth login YOUR_TOKEN
catops service install && catops service start
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: 
catops service stop
catops service remove
catops uninstall
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