Skip to main content
Cloud mode connects your CLI agent to the CatOps Cloud dashboard, enabling:
  • Web dashboard with metrics history
  • Telegram and email alerts
  • AI-powered server analysis
  • Multi-server monitoring

​
Getting Started

1

Create Account

Sign up at catops.app with email or GitHub.
2

Get Token

Go to Settings and copy your Agent Token.
3

Connect

catops auth login YOUR_TOKEN
4

Start Service

catops service install
catops service start
Your server now appears in the Cloud dashboard.

​
What Gets Sent

When connected to Cloud, the agent sends:
DataFrequency
CPU, memory, disk metricsEvery 10-30s
Network trafficEvery 10-30s
Process listEvery 30s
Service statusEvery 60s
No sensitive data (passwords, keys, file contents) is ever sent.

​
Check Connection Status

catops auth info
Output: 
Cloud Mode: enabled
Server ID: abc123
Last sync: 10 seconds ago

​
Disconnect from Cloud

To disable Cloud mode: 
catops auth logout
catops restart
The CLI continues to work locally, but:
  • Dashboard won’t show this server
  • Alerts won’t be sent
  • AI features won’t work

​
Troubleshooting

  1. Verify token: catops auth info
  2. Check daemon is running: catops service status
  3. Restart: catops restart
  4. Check network: curl https://api.catops.app/health
  1. Go to catops.app/settings
  2. Copy the token again
  3. Re-login: catops auth login NEW_TOKEN
  1. Check service: catops service status
  2. View logs: Look in ~/.catops/logs/
  3. Restart service: catops restart

​
Privacy

Cloud mode collects system metrics only:
  • No file contents
  • No environment variables
  • No passwords or secrets
  • No command history
You can review exactly what’s collected in Settings → Server → Data.