Commercial-Grade, Next-Generation Game Server Hosting Panel & Node Daemon
Engineered in high-concurrency Go, modern PHP 8, PostgreSQL 16, and Redis 7 as a powerful, ultra-responsive, white-label commercial alternative to Pterodactyl and Pelican.
+---------------------------------------------+
| Nginx + PHP 8 Web Portal |
| (Astrial Client & Admin Management) |
+----------------------+----------------------+
|
REST API / Bearer Token
v
+------------------------+ +---------------------------------------------+
| Billing Engines | | Astrial Control Plane |
| (WHMCS, Stripe, Wise) +------------>| (Go API Service) |
+------------------------+ +----------+-------------------+--------------+
| |
mTLS / JWT | | PostgreSQL 16
REST & WS | | Redis 7 Cache
v v
+-------------------+ +----------------------+
| Astrial Wings | | Database & Redis |
| (Go Node Daemon) | | Persistent Storage |
+---------+---------+ +----------------------+
|
Docker API Socket
v
+------------------------+
| Game Server Containers |
| (Minecraft, Rust, etc) |
+------------------------+
Astrial Panel splits workload management into three decoupled layers:
- Control Plane API (
panel-api): Compiled Go binary handling authentication, multi-tenant RBAC, egg templating, node allocation, billing webhooks, database provisioning, and transactional mailing. - Node Daemon (
daemon): High-performance Go daemon interfacing directly with/var/run/docker.sockover authenticated REST and WebSocket protocols for low-latency console streaming, interactive TTY, power lifecycle (start,restart,stop,kill), and live cgroup telemetry. - Web Management Portal (
web-php): Nginx + PHP 8 frontend with zero external framework overhead, featuring authentic Pterodactyl-grade server management, full 9-subtab server workspace, live terminal streaming, Monaco config editing, and zero-rebuild white-label theming.
- Native Pterodactyl & Pelican
.jsonEgg Importer & Exporter. - Pre-seeded with ready-to-deploy templates across all game tiers:
- Minecraft Ecosystem: Paper, Purpur, Folia, Velocity Proxy, BungeeCord, Fabric, Forge, NeoForge, Bedrock Dedicated Server.
- SteamCMD & Survival: Rust (Vanilla + Oxide/uMod), ARK: Survival Evolved & Ascended, Palworld, Valheim, Enshrouded, 7 Days to Die, Project Zomboid, V Rising, Conan Exiles, Factorio, Satisfactory, Unturned, Terraria (TShock).
- Competitive FPS: Counter-Strike 2 (CS2), Garry's Mod, Team Fortress 2, Left 4 Dead 2, Arma 3, Squad, Insurgency: Sandstorm.
- Roleplay Frameworks: FiveM, alt:V, RAGE Multiplayer, Multi Theft Auto (MTA:SA).
- Standalone Runtimes: Node.js, Python, Go, Java, Lavalink, standalone PostgreSQL/MariaDB/Redis containers, generic Alpine/Ubuntu sandboxes.
- Curated official Steam CDN game artwork banners for all templates and servers.
- Console: RFC 6455 low-latency WebSocket TTY stream with interactive command execution, live terminal logs, and real-time CPU, RAM, Disk, and Network telemetry.
- File Manager: Directory navigation, file uploads, syntax-highlighted code editor, and live file updates.
- Databases: Automated per-server MySQL/MariaDB database provisioning with secure password reveals and SSO links.
- Schedules: Cron-based automated schedules for recurring tasks, backups, and server restarts.
- Subusers & Permissions: Granular staff access controls without granting root administrative credentials.
- Backups: Full daemon-level tarball snapshots with lock and restore actions.
- Network: Port allocation dispatcher with primary port indicators.
- Startup: Docker image selector, startup command overrides, and interactive egg environment variable configuration.
- Settings: SFTP connection details and secure server re-installation.
- Live administrative branding editor:
- Company name, brand logo, and favicon URLs.
- 4K login page wallpapers with curated one-click high-resolution presets (Cyberpunk, Nebula, Datacenter, OLED Stealth).
- Theme engine supporting Pure OLED Black (
#000000), Dark Slate, and Light modes. - Primary, secondary, and accent color palette pickers with 6 reseller presets.
- Live CSS injection and analytics tracking script insertion with zero recompilation or container restarts.
- REST endpoints and webhooks compatible with WHMCS, Paymenter, Wise, and Stripe:
POST /api/client/provision: Automated instant provisioning with least-loaded node allocation.POST /api/servers/{id}/suspend: Graceful container stop and startup lock on overdue invoices.POST /api/servers/{id}/unsuspend: Immediate restoration upon payment clearance.- Zero-downtime plan resizing via live cgroups v2 limits.
- Integrated transactional SMTP delivery for automated notifications.
├── daemon/ # Wings-replacement Go node daemon (Docker socket & WebSocket TTY)
├── panel-api/ # Control Plane Go API (Fiber/PostgreSQL/Redis/Billing/Theme)
├── web-php/ # PHP 8 + Nginx frontend portal (Zero-rebuild UI & White-Label)
│ ├── views/
│ │ ├── header.php # Dynamic head, CSS variables, and branding
│ │ └── sidebar.php # Role-aware navigation (Client vs Admin)
│ ├── login.php # Commercial authentication portal
│ ├── index.php # Main server console, cluster HUD, and admin suites
│ └── helpers.php # Internal API client utilities
├── eggs/ # 44+ pre-seeded Pterodactyl/Pelican game templates
├── deploy/ # Dockerfiles, Nginx configurations, and deployment scripts
├── tests/ # Comprehensive Playwright E2E and integration test suite
└── docker-compose.dev.yml # Local test infrastructure (PostgreSQL 16, Redis 7, Mailpit)
- Docker & Docker Compose
- Go 1.22+
- PHP 8.0+ & Nginx
Astrial Panel is designed for real hosting infrastructure deployments across public domains, reverse proxies, and remote database clusters.
Run the automated installer on your VPS or dedicated server:
sudo bash deploy/install.shThe installer configures Nginx, PHP-FPM, Docker, PostgreSQL client, writes production environment parameters, and launches system services.
When deploying Astrial Panel on a new server, open your browser to:
http://YOUR_SERVER_IP/install.php
# or https://panel.yourdomain.com/install.php
The interactive wizard guides you through:
- Live PostgreSQL Connection Test: Verifies host, port, credentials, and connectivity before proceeding.
- Environment & Domain Setup: Sets your public panel domain, company/brand name, and primary node FQDN.
- Root Administrator Account Creation: Custom admin email, username, and password with secure bcrypt hashing.
- Automated Migration & Lock: Runs database table migrations, seeds 44+ game egg engines, creates the
.envfile, and locks the installer (installed.lock) against unauthorized access.
Astrial Panel reads configuration from .env or system environment variables:
cp .env.example .env
nano .envKey configuration parameters:
APP_URL: Your public domain (e.g.,https://panel.yourhosting.com).DATABASE_URL: PostgreSQL connection string (postgres://user:pass@host:5432/dbname?sslmode=disable).PANEL_API_URL: Internal API endpoint (http://127.0.0.1:8080). In production, Nginx reverse proxies/api/directly to this service, so port:8080remains internal and is never exposed to public internet traffic.DAEMON_URL: Node daemon connection endpoint (e.g.,http://node1.yourhosting.com:8081).
- Docker & Docker Compose
- Go 1.22+
- PHP 8.0+ & Nginx
docker compose -f docker-compose.dev.yml up -dSpins up PostgreSQL 16 (:5432), Redis 7 (:6379), and Mailpit (:1025/:8025).
cd panel-api
go build -o /usr/local/bin/astrial-api .
astrial-apiThe API starts on port :8080 (internally accessed by Nginx and /install.php).
cd daemon
go build -o /usr/local/bin/astrial-daemon .
astrial-daemonThe daemon starts on port :8081 and connects directly to /var/run/docker.sock.
Serve web-php via Nginx or PHP:
cd web-php
php -S 0.0.0.0:8000Open http://localhost:8000 in your browser.
Astrial Panel includes a comprehensive end-to-end automated verification suite using Playwright:
python3 tests/e2e/test_gamepanel_e2e.pyThe test suite validates:
- Unauthenticated route protection and login redirection.
- Invalid credential rejection and error messaging.
- Client portal isolation (strict hiding of administrative infrastructure).
- Administrator console elevation and user fleet management.
- Live Zero-Rebuild Theme Studio (DOM CSS variables updated dynamically).
- 44+ game egg catalog rendering and custom Pterodactyl
.jsonegg import. - WSL node telemetry and hardware health monitoring.
- Automated server provisioning, Docker container boot, and WebSocket TTY command execution.
- Billing suspension/unsuspension lifecycle and transactional SMTP email delivery in Mailpit.
- Monaco-style file manager reading, editing, and disk persistence.
Astrial Panel is open-source software licensed under the MIT License.