Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/calagopus/panel/llms.txt

Use this file to discover all available pages before exploring further.

Calagopus is a self-hosted game server management panel written in Rust and React. It is a direct alternative to Pterodactyl Panel, fully compatible with existing Wings nodes, and designed to eliminate the performance and flexibility limitations of the original PHP-based panel.

What Calagopus is

The Calagopus backend is built with Rust and the Axum web framework. The frontend uses React 19, Mantine, and Tailwind. Both are distributed as a single Docker image. Because Wings compatibility is preserved, you do not need to reinstall or reconfigure any Wings daemons when switching from Pterodactyl. All existing Wings nodes, eggs, and server allocations carry over.

How Calagopus differs from Pterodactyl

Rust backend

Axum handles thousands of concurrent connections with a fraction of the memory that a Laravel/PHP process requires.

React + Mantine UI

The panel interface loads fast, updates without full-page reloads, and ships with a consistent component system.

Extension system

Auth providers, frontend plugins, and backend modules can be loaded without touching core panel code.

Role-based access

Granular admin roles let you delegate specific tasks — node management, user management, and more — without granting full admin access.

OAuth2 and passkeys

First-class OAuth2 login and passkey support is built in; no plugins or external services are required.

Performance caching

Optional in-memory and Redis decryption caches reduce database round-trips on high-traffic panels.

Minimum requirements

ComponentRequirement
Container runtimeDocker with Compose
DatabasePostgreSQL (bundled in the official Compose file)
CacheValkey or Redis (bundled in the official Compose file)
Wings nodeAny Wings-compatible daemon; at least one node required to create servers
The official compose.yml bundles PostgreSQL and Valkey alongside the panel. For small installations you do not need to provision these separately.

Get started

Quick start

Deploy Calagopus with Docker Compose and create your first admin account in about five minutes.

Full installation

Step-by-step guide covering Docker setup, reverse proxy configuration, and post-install hardening.

Migrate from Pterodactyl

Import users, servers, nodes, eggs, and backups from an existing Pterodactyl installation.

API reference

Explore the REST API for managing servers, users, nodes, and more programmatically.

Build docs developers (and LLMs) love