Note
Airlink 2.0.0 is stable and ready for production. If it breaks, you probably forgot to set SESSION_SECRET -_-
Open-source game server management that actually works -_-
Airlink Panel is the brain of the operation. It's a web-based control center for deploying, monitoring, and managing game servers across multiple machines. Think of it as the thing that yells at the daemon so you don't have to -_-
What you get:
- Full web UI for admins and users (EJS templates, not React - we like it simple)
- Node-based architecture - one panel, many daemons, infinite game servers
- Addon system for extending functionality without touching core code
- REST API (v1 + legacy) for automation and third-party integrations
- Real-time console, file manager, backups, SFTP, and more
For full documentation, visit airlinklabs.xyz/docs/quick-start/.
| Handle | Role | What they do |
|---|---|---|
| thavanish | Maintainer | Keeps the lights on and the semicolons in place |
| privt00 | Project lead | The one who said "let's build a game panel" and meant it |
| achul123 | Core developer | Writes code that works on the first try (sometimes) |
- Node.js v18 or later
- pnpm v8 or later (
npm install -g pnpm) - Git
- A sense of humor (optional but recommended)
sudo su
bash <(curl -s https://raw.githubusercontent.com/airlinklabs/panel/refs/heads/main/installer.sh)This handles everything: Node.js, Docker, database, build, systemd service. Just sit back and watch the progress bar -_-
Manage with systemd:
systemctl start airlink-panel
systemctl stop airlink-panel
systemctl restart airlink-panel
journalctl -u airlink-panel -fcd /var/www/
git clone https://github.com/AirlinkLabs/panel.git
cd panel
# Set permissions
chown -R www-data:www-data /var/www/panel
chmod -R 755 /var/www/panel
# Install dependencies
pnpm install
# Set up environment
cp example.env .env
# Edit .env - set PORT, URL, SESSION_SECRET, and DATABASE_URL
# One command to rule them all
pnpm run setup
# Start the panel
pnpm run startpnpm run setup does the heavy lifting: installs deps, generates Prisma client, pushes database schema, and builds TypeScript + CSS.
npm install -g pm2
pm2 start "pnpm run start" --name airlink-panel
pm2 save
pm2 startupCopy example.env to .env and fill in the required values:
| Variable | Required | Description |
|---|---|---|
NAME |
No | Panel display name (default: Airlink) |
NODE_ENV |
Yes | Set to production for live deployments |
URL |
Yes | Full URL the panel is served from, e.g. http://192.168.1.10:3000 |
PORT |
Yes | Port to listen on |
DATABASE_URL |
Yes | SQLite path, e.g. file:./storage/dev.db |
SESSION_SECRET |
Yes | Random secret for session signing - use openssl rand -hex 32 |
Important
DATABASE_URL must be an absolute path in production (e.g. file:/var/www/panel/storage/dev.db). Relative paths break when started from a different working directory (e.g. via systemd). This is not a suggestion. This is a warning -_-
Important
URL should be the actual IP or hostname the panel is accessible from. Setting it to http://localhost will prevent network access and cause CSP issues. Your browser will judge you -_-
The panel exposes a full REST API. See docs/specsheet.md for the complete route catalog with request/response formats, authentication details, and how the panel talks to the daemon.
TL;DR: 138 HTTP routes, 4 WebSocket endpoints, HMAC-signed daemon communication, scoped API keys with granular permissions.
Addons extend the panel without modifying core files. They live under storage/addons/ and are managed from /admin/addons.
See storage/addons/README.md for structure and API reference.
# Install deps
pnpm install
# Start in dev mode (auto-restart on changes)
pnpm run dev
# Typecheck
pnpm run typecheck
# Lint
pnpm run lint
# Build for production
pnpm run build- Fork the repository
- Create a feature branch:
git checkout -b feature/your-feature - Commit:
git commit -m 'feat: describe your change' - Push and open a pull request against
main
Run pnpm run lint and pnpm run typecheck before submitting. If your PR breaks the build, we will find you -_-
- Website: airlinklabs.xyz
- Docs: airlinklabs.xyz/docs/quick-start
- Discord: discord.gg/ujXyxwwMHc
- GitHub: github.com/airlinklabs/panel
MIT - see LICENSE for details.
