Unofficial installation and management scripts for Calagopus Panel & Wings - a modern, Docker-first, ARM-friendly game server panel.
Inspired by pterodactyl-installer, built specifically for Calagopus' Rust-powered architecture.
bash <(curl -sSL https://raw.githubusercontent.com/AnAverageBeing/calagopus-installer/main/install.sh)
β οΈ Root required - Some systems needsudobefore running this command.
# Full stack (Panel + Wings)
bash <(curl -sSL https://raw.githubusercontent.com/AnAverageBeing/calagopus-installer/main/install.sh) -- \
--non-interactive --yes --action install_full --target full --mode docker --channel stable
# Panel only (native binary, without Docker)
bash <(curl -sSL https://raw.githubusercontent.com/AnAverageBeing/calagopus-installer/main/install.sh) -- \
--non-interactive --yes --action install_panel_native --target panel --mode native --channel stable
# Wings only (Docker)
bash <(curl -sSL https://raw.githubusercontent.com/AnAverageBeing/calagopus-installer/main/install.sh) -- \
--non-interactive --yes --action install_wings --target wings --mode docker \
--wings-join-data "your-join-token-here"|
Installation & Deployment
|
Operations
|
|
Security & Infrastructure
|
Compatibility
|
| OS | Version | Support | Arch |
|---|---|---|---|
| Ubuntu | 22.04, 24.04, 26.04 | β Full | x86_64, ARM64 |
| Debian | 11, 12, 13 | β Full | x86_64, ARM64 |
| Rocky Linux | 8, 9 | β Full | x86_64, ARM64 |
| AlmaLinux | 8, 9 | β Full | x86_64, ARM64 |
| RHEL | 8, 9 | β Full | x86_64, ARM64 |
| Fedora | 38+ | β Full | x86_64, ARM64 |
| Arch Linux | rolling | β Full | x86_64, ARM64 |
| openSUSE | Tumbleweed, Leap 15.5+ | β Full | x86_64, ARM64 |
| Raspberry Pi OS | 11+ | β Full | ARM64 |
| Other (Docker) | Any | π‘ Community | All |
| Arch | Support | Notes |
|---|---|---|
| x86_64 / amd64 | β | Primary target |
| aarch64 / arm64 | β | Raspberry Pi 4/5, ARM servers |
| armv7 | β | Raspberry Pi 3 |
| riscv64 | β | Experimental |
| ppc64le | β | POWER systems |
| Mode | Setup | Best For |
|---|---|---|
| Docker AIO | Panel + Wings in one container | Single-node, recommended for most |
| Docker Standalone | Panel only, Wings separate | Multi-node, distributed setups |
| Native Binary | Compiled Rust + systemd | Minimal footprint, no Docker |
| Channel | Tag | Notes |
|---|---|---|
| Stable (recommended) | :latest / :aio |
Production-ready, latest release |
| Beta | :latest-pre / :heavy-pre |
New features, may have bugs |
| Nightly | :nightly / :nightly-aio |
Development builds, unstable |
Run the installer and choose your setup:
sudo bash src/installer.shAvailable options:
| # | Action | Description |
|---|---|---|
| 1 | Install Panel Only (without Docker) | Deploy Calagopus Panel using native binaries + systemd |
| 2 | Install Panel+Wings (Full Stack) | Panel + Wings on one host via AIO Docker image |
| 3 | Install Panel Only (Docker) | Deploy Calagopus Panel using Docker Compose |
| 4 | Install Wings Only | Deploy Calagopus Wings node |
| 5 | Upgrade Installation | Update to latest release on your channel |
| 6 | Repair Installation | Auto-detect and fix common issues |
| 7 | Backup Installation | Create full backup bundle (DB + config) |
| 8 | Restore Installation | Restore from backup |
| 9 | Reconfigure Installation | Re-run setup wizard |
| 10 | Remove Installation | Full clean uninstall (containers, files, configs, optionally DB) |
| 11 | Show System Status | Health overview |
--action <action> install_panel_native | install_panel_docker | install_wings | install_full | upgrade | repair | backup | restore | remove | status
--target <target> panel | wings | full
--mode <mode> docker | native
--channel <channel> stable | beta | nightly
--non-interactive Skip all prompts (use defaults)
--yes Assume 'yes' to all confirmations
--dry-run Show what would happen (no changes)
--verbose / --debug More logging
--quiet Suppress non-error output
--no-color Disable colored output
--config <file> Load config from env file
--wings-join-data <token> Node join token for Wings
--version Show version
--help Show helpAfter installation, use the calagopus-installer command:
# Status & Monitoring
calagopus-installer status # Quick health overview
calagopus-installer doctor # Deep health check (fails on issues)
calagopus-installer logs -f # Follow installer logs (tail -f)
calagopus-installer logs 100 # Last 100 lines
# Operations
calagopus-installer upgrade # Update to latest release
calagopus-installer repair # Auto-detect and fix issues
calagopus-installer reconfigure # Re-run setup wizard
# Backup & Restore
calagopus-installer backup # Create full backup bundle
calagopus-installer restore # Restore from backup (interactive)
# Cleanup
calagopus-installer remove # Uninstall (interactive confirmation)
calagopus-installer version # Show CLI version
calagopus-installer help # Show helpConfigure periodic backups with systemd timers:
# During install, configure:
BACKUP_SCHEDULE=daily # hourly | daily | weekly | monthly
BACKUP_RETENTION=7 # Keep last N bundlesAutomatic firewall setup with multiple backends:
| Backend | Distro | Default |
|---|---|---|
| UFW | Debian/Ubuntu/Arch | β Preferred |
| firewalld | RHEL/Fedora/SUSE | β Preferred |
| nftables | Any | |
| iptables | Any |
Default ports opened:
22 TCP SSH
8000 TCP Panel HTTP
8443 TCP Panel HTTPS
443 TCP Wings
20000:20100 TCP Game server allocations
| Option | Type | Best For | Requirements |
|---|---|---|---|
| Let's Encrypt β | Auto | Production | FQDN + ports 80/443 |
| Self-signed | Manual | Testing/Homelab | None (OpenSSL) |
| Existing Certs | Manual | Custom setup | fullchain.pem + privkey.pem |
| Cloudflare Origin | Auto | Cloudflare users | Cloudflare account |
Auto-renewal configured for Let's Encrypt with proxy reload hook.
calagopus-installer/
βββ π install.sh curl bootstrap entrypoint
βββ π src/
β βββ installer.sh Main orchestrator
β βββ lib/ Core libraries
β β βββ common.sh Constants & shared state
β β βββ log.sh Structured logging + redaction
β β βββ ui.sh Terminal UI (colors, menus)
β β βββ crypto.sh Secure credential generation
β β βββ config.sh Config load/save/validate
β β βββ system.sh Host capability detection
β β βββ trap.sh Error handling & cleanup
β βββ os/ OS detection & per-family setup
β β βββ detect.sh Distro detection
β β βββ debian.sh Ubuntu/Debian repos
β β βββ rhel.sh RHEL/Rocky/Alma/Fedora
β β βββ arch.sh Arch Linux setup
β β βββ suse.sh openSUSE setup
β βββ dependencies/ Dependency provisioning
β β βββ manager.sh Central facade
β β βββ docker.sh Docker Engine + Compose
β β βββ postgres.sh PostgreSQL
β β βββ redis.sh Redis / Valkey
β β βββ nginx.sh Nginx reverse proxy
β β βββ caddy.sh Caddy reverse proxy
β β βββ certbot.sh Let's Encrypt
β β βββ packages.sh Helper utilities
β βββ database/ Database lifecycle
β β βββ postgres.sh Provisioning (local/remote)
β β βββ validate.sh Connectivity & schema checks
β βββ docker/ Docker daemon config
β βββ panel/ Panel installation
β βββ wings/ Wings installation
β βββ ssl/ SSL/TLS lifecycle
β βββ proxy/ Nginx + Caddy config
β βββ firewall/ UFW/firewalld/nftables
β βββ backup/ Backup & restore bundles
β βββ update/ Upgrades & rollback
β βββ repair/ Auto-repair probes
β βββ uninstall/ Clean removal
β βββ monitoring/ Status & health checks
βββ π scripts/cli.sh Installed CLI shim
βββ π configs/defaults.env Default configuration
βββ π templates/ Config templates
βββ π tests/ Bats unit tests
βββ π .github/workflows/ CI/CD pipelines
βββ π Vagrantfile Integration test VMs
βββ π LICENSE, CHANGELOG.md, etc.
bash 4+ # Shell interpreter
shellcheck # Linting
bats-core # Unit testing
Vagrant # Integration testing (optional)Quick test with Vagrant:
vagrant up # All distributions
vagrant up ubuntu_jammy # Single distro
vagrant ssh ubuntu_jammy # SSH into box
sudo /vagrant/src/installer.shAvailable test boxes:
ubuntu_jammy (22.04) | ubuntu_noble (24.04) | debian_bookworm (12)
debian_trixie (13) | rockylinux_9 | almalinux_9
fedora_40 | archlinux
# Lint all scripts
find . -type f -name '*.sh' -not -path './.git/*' -exec shellcheck -x {} +
# Run unit tests
bats tests/- Update
CHANGELOG.mdwith release info - Bump
CALAGOPUS_INSTALLER_VERSIONinsrc/lib/common.sh - Commit:
git commit -m "Release vX.Y.Z" - Tag:
git tag vX.Y.Z - Push & create GitHub release (CI auto-attaches binaries)
π Open an issue
π Join Discord
MIT - see LICENSE file for details.
- pterodactyl-installer - Original inspiration
- Calagopus - The panel this installer deploys
- All contributors making open-source better
If you find this helpful, please consider starring the repo!
Donations are appreciated!
Bitcoin: bc1qqdhanefhpfht66urta6yws03pc060gmz26k9dt