Skip to main content

​
Quick Install

Run this command on your server: 
curl -fsSL https://get.catops.app/hub.sh | sh
Requires root access. The script will use sudo automatically.

​
What Happens

The script will:
  1. Download the latest CatOps Hub
  2. Create catops system user
  3. Install to /opt/catops/
  4. Add user to docker group (for container monitoring)
  5. Set up systemd service
  6. Start the dashboard on port 8090

​
Installation Options

​
Custom Port

curl -fsSL https://get.catops.app/hub.sh | sh -s -- -p 9000

​
Enable Auto-updates

curl -fsSL https://get.catops.app/hub.sh | sh -s -- --auto-update
Creates a systemd timer that checks for updates daily.

​
All Options

OptionDescription
-p <port>Custom port (default: 8090)
--auto-updateEnable automatic daily updates
-uUninstall CatOps Hub
-h, --helpShow help

​
After Installation

You’ll see: 
CatOps Hub installed successfully!

Dashboard: http://YOUR_IP:8090
Data dir:  /opt/catops/data

Next steps:
  1. Open http://YOUR_IP:8090 in your browser
  2. Create your admin account
  3. Activate your license at /activate

​
Updating

To update CatOps Hub to the latest version: 
curl -fsSL https://get.catops.app/update-hub.sh | sh
Or if you installed with --auto-update, updates happen daily automatically.

​
Managing the Service

sudo systemctl status catops-hub

​
Open Firewall Port

Make sure port 8090 is accessible: 
sudo ufw allow 8090

​
Supported Systems

OSArchitecture
Linuxx86_64, ARM64, ARM
macOSIntel, Apple Silicon
FreeBSDx86_64

​
Troubleshooting

Check logs:
sudo journalctl -u catops-hub -n 50
Common issues:
  • Port already in use - use -p to change port
  • Permission denied - reinstall the script
The install script adds catops user to docker group automatically. If containers still don’t show:
sudo usermod -aG docker catops
sudo systemctl restart catops-hub
  • Check firewall settings
  • Verify service is running: systemctl status catops-hub
  • Try locally: curl http://localhost:8090