Instalasi Wings

Wings adalah daemon yang jalan di setiap node (mesin fisik/VPS yang jadi tempat game server berjalan). Wings menerima perintah dari panel dan mengelola container Docker.

Requirement node

• Ubuntu 22.04 LTS / Debian 11+
• Kernel Linux 5.x+
• Minimal 2 vCPU, 4 GB RAM per node
• Docker
• Port yang perlu dibuka: 8080, 2022, 443 (jika pakai SSL)

1. Install Docker

curl -sSL https://get.docker.com/ | CHANNEL=stable bash
systemctl enable --now docker

2. Enable swap accounting

Edit GRUB:

nano /etc/default/grub

Ubah baris GRUB_CMDLINE_LINUX_DEFAULT:

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash swapaccount=1"

Update GRUB dan reboot:

update-grub
reboot

3. Download Wings

mkdir -p /etc/pterodactyl
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64")"
chmod u+x /usr/local/bin/wings

4. Setup systemd service

nano /etc/systemd/system/wings.service

[Unit]
Description=Pterodactyl Wings Daemon
After=docker.service
Requires=docker.service
PartOf=docker.service

[Service]
User=root
WorkingDirectory=/etc/pterodactyl
LimitNOFILE=4096
PIDFile=/var/run/wings/daemon.pid
ExecStart=/usr/local/bin/wings
Restart=on-failure
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target

systemctl daemon-reload

5. Buat node di panel

Login panel → Admin → Nodes → Create New.

Isi form:

• Name: node-1
• Description: Node utama
• Location: pilih atau buat baru
• FQDN: node1.aryapanel.xyz (harus resolve ke IP node)
• HTTPS: yes (rekomendasi)
• Memory / Disk: total resource node

Setelah node dibuat, buka tab Configuration → Generate Token → copy paste ke /etc/pterodactyl/config.yml di node:

nano /etc/pterodactyl/config.yml

6. Jalankan Wings

Coba manual dulu:

wings --debug

Jika muncul [INFO] Configuration file successfully loaded., tekan Ctrl+C dan jalankan sebagai service:

systemctl enable --now wings

7. Verifikasi

Di panel → Admin → Nodes → node Anda → indikator harus hijau (Heartbeat OK).

8. Konfigurasi firewall

ufw allow 8080/tcp   # Wings API
ufw allow 2022/tcp   # SFTP
ufw allow 25565/tcp  # Minecraft (contoh)
ufw enable

9. SSL untuk Wings

Wings butuh SSL kalau panel pakai HTTPS.

apt install -y certbot
certbot certonly --standalone -d node1.aryapanel.xyz

Update /etc/pterodactyl/config.yml:

api:
  ssl:
    enabled: true
    cert: /etc/letsencrypt/live/node1.aryapanel.xyz/fullchain.pem
    key: /etc/letsencrypt/live/node1.aryapanel.xyz/privkey.pem

Restart:

systemctl restart wings

Troubleshooting

"Failed to complete boot process: docker: is your daemon running?" — Docker belum jalan:

systemctl start docker

"cannot open config.yml" — token belum di-generate di panel.

Heartbeat merah di panel — cek firewall dan SSL cert.

journalctl -u wings -f