Quick Start - CatOps

Choose Your Path

Cloud (Recommended)
Hub (Self-Hosted)
CLI Only

Best for: Quick setup, no infrastructure management, free tier

Create Account

Go to catops.app and sign up with email or GitHub.

Install Agent

Run this on your server:

curl -fsSL https://get.catops.app/install.sh | bash

Don’t use sudo - the CLI installs to your home directory.

Connect to Cloud

Copy your auth token from the dashboard and run:

catops auth login YOUR_TOKEN

Start Monitoring

catops service install
catops service start

That’s it! Your server now appears in the Cloud dashboard.

Best for: Privacy-focused, air-gapped networks, data sovereignty

Install Hub

Run on your server (requires root):

curl -fsSL https://get.catops.app/hub.sh | sudo sh

Open Dashboard

Navigate to:

http://your-server-ip:8090

Create Admin Account

Set up your admin username and password on first visit.

Activate License

Go to Settings → Activate and enter your license key.

Get a License

Purchase at catops.app/hub-licenses

Best for: Local monitoring, quick server checks, no dashboard needed

Install CLI

curl -fsSL https://get.catops.app/install.sh | bash

Check Status

catops status

You’ll see CPU, memory, disk, and network metrics.

View Processes

catops processes

Shows top processes by CPU and memory usage.

Ask AI (Optional)

catops ask "why is my disk full?"

Requires Cloud mode for AI features.

What’s Next?

Add Health Checks

Monitor your websites and APIs

Set Up Alerts

Get notified via Telegram, email, or Slack

Add More Servers

Install the agent on additional servers

Docker Monitoring

Monitor your containers and logs

Troubleshooting

Agent not connecting to Cloud

Check your auth token: catops auth info
Restart the service: catops restart
Check logs: catops service status

Hub dashboard not loading

Check if service is running: systemctl status catops-hub
Check firewall: sudo ufw allow 8090
View logs: journalctl -u catops-hub -f

Permission denied during install

For CLI: Don’t use sudo, it installs to ~/.local/bin
For Hub: You need sudo as it installs to /opt/catops

Getting Started

Cloud

Hub

CLI

Documentation Index

​Choose Your Path

Get a License

​What’s Next?

Add Health Checks

Set Up Alerts

Add More Servers

Docker Monitoring

​Troubleshooting

Choose Your Path

What’s Next?

Troubleshooting