About
What Skyport is, how it works, and how the pieces fit together.
Skyport is a game server management platform designed for self-hosted deployments.
Architecture
Section titled “Architecture”The project follows the same model familiar from Pterodactyl:
- A central panel for users, administrators, and server management
- One or more nodes that host game server workloads
- A daemon on each node that manages Docker containers on behalf of the panel
The panel is a modern Laravel application:
| Layer | Technology |
|---|---|
| Backend | Laravel 13, PHP 8.4 |
| Frontend | React 19, Inertia.js v2, Tailwind CSS v4 |
| Build | Vite, Bun |
| App server | Laravel Octane + Swoole |
| SSR | Inertia server-side rendering (Node.js) |
| Database | SQLite (default) or MySQL/MariaDB |
skyportd
Section titled “skyportd”The daemon is a Rust binary that handles:
- Node enrollment with the panel
- Configuration sync
- API serving for the panel
- WebSocket sessions for live console interaction
- Docker container lifecycle management
- Local state persistence (SQLite)
Supported architectures: x86_64, aarch64 (ARM64), riscv64.
Request flow
Section titled “Request flow”- Administrator creates a location and node in the panel
- Panel generates a one-time configuration token
skyportdenrolls with the panel using the token- Panel syncs server definitions to the daemon
- Daemon manages Docker containers for each server
- Users interact with their servers through the panel UI
Deployment
Section titled “Deployment”A typical small deployment:
- One panel VM (runs the web app, database, and queue worker)
- One or more node machines (each running
skyportdand Docker)
For larger setups, separate the database and use Redis for cache/sessions/queues.
Comparison with Pterodactyl
Section titled “Comparison with Pterodactyl”If you are coming from Pterodactyl:
| Pterodactyl | Skyport |
|---|---|
| Egg | Cargo |
| Wings | skyportd |
| Blade templates | React + Inertia SSR |
| PHP-FPM + Nginx | Octane (Swoole) + Nginx |
| MySQL required | SQLite default, MySQL optional |
Current expectations
Section titled “Current expectations”Skyport is intended for administrators comfortable with self-hosting. It assumes you can:
- Secure Linux hosts
- Manage reverse proxies and TLS
- Read application and service logs
- Operate Docker-based infrastructure