Installation

The supported path is the Docker installer: one script sets up the panel, PostgreSQL, Redis, and a reverse proxy.

1. Run the installer

On the panel host, as root (or with sudo):

bash install.sh

Useful flags:

• -y — non-interactive (accept defaults).
• --dry-run — show what would happen without changing anything.
• --uninstall — remove a Catalyst Docker installation.
• --help — all options.

The installer downloads release artifacts and verifies their SHA-256 checksums before executing anything. If verification fails, it aborts — do not bypass it.

2. What gets installed

Into catalyst-docker/ (the target directory):

• Panel (backend + frontend containers).
• PostgreSQL and Redis for data and caches/queues.
• A reverse-proxy profile — Caddy or Traefik (see docker-compose.caddy.yml / docker-compose.traefik.yml in catalyst-docker/).

3. Finish setup in the browser

Open the panel URL and complete the setup wizard (first-time setup): admin account, panel URL, and basic settings.

After installing

• Configure TLS and networking.
• Install a node — the panel alone runs no games.
• Update safely when new releases arrive.

Troubleshooting

• Installer fails early: re-run with --dry-run to see the planned steps, and check Docker/Compose are present and your user can reach the Docker socket.
• Panel 500s on first login: the database migrations run at container startup — wait a minute and check container logs (docker compose logs backend).
• More: panel issues.