Installation

Quick Install

Run this command on your server:

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

Requires root access. The script will use sudo automatically.

What Happens

The script will:

Download the latest CatOps Hub
Create catops system user
Install to /opt/catops/
Add user to docker group (for container monitoring)
Set up systemd service
Start the dashboard on port 8090

Installation Options

Custom Port

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

Enable Auto-updates

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

Creates a systemd timer that checks for updates daily.

All Options

Option	Description
`-p <port>`	Custom port (default: 8090)
`--auto-update`	Enable automatic daily updates
`-u`	Uninstall CatOps Hub
`-h, --help`	Show 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

sudo systemctl restart catops-hub

sudo journalctl -u catops-hub -f

sudo systemctl stop catops-hub

Open Firewall Port

Make sure port 8090 is accessible:

sudo ufw allow 8090

sudo firewall-cmd --add-port=8090/tcp --permanent
sudo firewall-cmd --reload

Supported Systems

OS	Architecture
Linux	x86_64, ARM64, ARM
macOS	Intel, Apple Silicon
FreeBSD	x86_64

Troubleshooting

Service fails to start

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

Docker containers not showing

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

Cannot access dashboard

Check firewall settings
Verify service is running: systemctl status catops-hub
Try locally: curl http://localhost:8090

Getting Started

Cloud

Hub

CLI

Quick Install

What Happens

Installation Options

Custom Port

Enable Auto-updates

All Options

After Installation

Updating

Managing the Service

Open Firewall Port

Supported Systems

Troubleshooting

​Quick Install

​What Happens

​Installation Options

​Custom Port

​Enable Auto-updates

​All Options

​After Installation

​Updating

​Managing the Service

​Open Firewall Port

​Supported Systems

​Troubleshooting

Quick Install

What Happens

Installation Options

Custom Port

Enable Auto-updates

All Options

After Installation

Updating

Managing the Service

Open Firewall Port

Supported Systems

Troubleshooting