Cara Install Pterodactyl Panel & Wings

AtharsTech

Cara Install Pterodactyl Panel & Wings — Panduan Lengkap 2025

Persyaratan	Detail
Sistem Operasi	Ubuntu 20.04 / 22.04 / 24.04 LTS (disarankan), Debian 11/12, Rocky Linux 8/9
Akses	Akses `root` atau user dengan hak `sudo`
Jaringan	IP publik yang stabil
Domain	Domain yang sudah diarahkan ke IP server (misal: `panel.domain.com`)
PHP	Versi 8.1, 8.2, atau 8.3 (8.3 disarankan)
Database	MySQL 5.7.22+ / MySQL 8.0+, atau MariaDB 10.2+ (10.6+ disarankan)
Web Server	Nginx (disarankan) atau Apache dengan `mod_rewrite`
Redis	Untuk caching dan antrian (queue)
Composer	Versi 2.x (terbaru)
Hardware	Minimal: 1 vCPU, 1 GB RAM (disarankan 2 GB+), 10 GB disk

bash

# Update sistem
apt update && apt upgrade -y

# Install tools dasar
apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg

# Tambahkan repository PHP 8.3 (Ubuntu)
LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php

# Tambahkan repository Redis resmi (opsional, untuk versi terbaru)
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list

# Update daftar repositori
apt update

# Install PHP 8.3, MariaDB, Nginx, Redis, dan utilitas
apt -y install php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server

sql

-- Buat user database (GANTI 'passwordKuat' dengan password yang kuat!)
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'passwordKuat';

-- Buat database
CREATE DATABASE panel;

-- Berikan hak akses penuh
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;

FLUSH PRIVILEGES;
EXIT;

bash

# Buat direktori instalasi
mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl

# Download rilis panel terbaru
curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz

# Ekstrak file
tar -xzvf panel.tar.gz

# Set permission yang benar
chmod -R 755 storage/* bootstrap/cache/

bash

# Salin file environment
cp .env.example .env

# Install dependensi Composer (mode produksi)
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader

# Generate kunci enkripsi aplikasi
php artisan key:generate --force

bash

# Setup environment umum (URL, timezone, cache/session/queue driver)
# Disarankan: pilih "redis" untuk cache, session, dan queue driver
php artisan p:environment:setup

# Konfigurasi koneksi database
# Masukkan: host (127.0.0.1), port (3306), database (panel), username, password
php artisan p:environment:database

# Konfigurasi email (opsional, untuk notifikasi)
# Pilih: smtp, mailgun, mandrill, atau postmark
php artisan p:environment:mail

bash

# Untuk Nginx atau Apache di Ubuntu/Debian:
chown -R www-data:www-data /var/www/pterodactyl/*

# Untuk CentOS/Rocky dengan Nginx: chown -R nginx:nginx /var/www/pterodactyl/*
# Untuk CentOS/Rocky dengan Apache: chown -R apache:apache /var/www/pterodactyl/*

nginx

server_tokens off;

server {
    listen 80;
    server_name panel.domain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name panel.domain.com;

    root /var/www/pterodactyl/public;
    index index.php;

    access_log /var/log/nginx/pterodactyl.app-access.log;
    error_log  /var/log/nginx/pterodactyl.app-error.log error;

    # Izinkan upload file besar
    client_max_body_size 100m;
    client_body_timeout 120s;
    sendfile off;

    # Konfigurasi SSL
    ssl_certificate /etc/letsencrypt/live/panel.domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/panel.domain.com/privkey.pem;
    ssl_session_cache shared:SSL:10m;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384";
    ssl_prefer_server_ciphers on;

    # Header Keamanan
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";
    add_header X-Robots-Tag none;
    add_header Content-Security-Policy "frame-ancestors 'self'";
    add_header X-Frame-Options DENY;
    add_header Referrer-Policy same-origin;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \\.php$ {
        fastcgi_split_path_info ^(.+\\.php)(/.+)$;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param PHP_VALUE "upload_max_filesize = 100M \n post_max_size=100M";
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param HTTP_PROXY "";
        fastcgi_intercept_errors off;
        fastcgi_buffer_size 16k;
        fastcgi_buffers 4 16k;
        fastcgi_connect_timeout 300;
        fastcgi_send_timeout 300;
        fastcgi_read_timeout 300;
    }

    location ~ /\\.ht {
        deny all;
    }
}

bash

# Hapus konfigurasi default
rm /etc/nginx/sites-enabled/default

# Aktifkan konfigurasi Pterodactyl
ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf

# Test dan restart Nginx
nginx -t
systemctl restart nginx

ini

# Pterodactyl Queue Worker File
# ----------------------------------

[Unit]
Description=Pterodactyl Queue Worker
After=redis-server.service

[Service]
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target

bash

# Buat direktori konfigurasi Wings
sudo mkdir -p /etc/pterodactyl

# Download binary Wings (otomatis deteksi arsitektur x86_64/arm64)
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")"

# Berikan permission eksekusi
sudo chmod u+x /usr/local/bin/wings

ini

[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

bash

# Panel server
sudo ufw allow 80        # HTTP
sudo ufw allow 443       # HTTPS

# Wings server
sudo ufw allow 8080      # Wings daemon port
sudo ufw allow 2022      # Wings SFTP port
sudo ufw allow 25565:25600/tcp   # Port game server (sesuaikan)
sudo ufw allow 25565:25600/udp

sudo ufw enable

✅ Cek	Perintah / Aksi
Panel bisa diakses	Buka `https://panel.domain.com` di browser
Login berhasil	Login dengan akun admin yang sudah dibuat
SSL valid	Cek ikon gembok di browser
Queue berjalan	`sudo systemctl status pteroq` → "active"
Redis berjalan	`sudo systemctl status redis-server` → "active"
Nginx berjalan	`sudo systemctl status nginx` → "active"
PHP-FPM berjalan	`sudo systemctl status php8.3-fpm` → "active"
Docker berjalan	`sudo systemctl status docker` → "active"
Wings terkoneksi	Panel: Admin → Nodes → node berwarna hijau

bash

APP_URL=https://panel.domain.com
APP_TIMEZONE=Asia/Jakarta
APP_ENVIRONMENT_ONLY=false

DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=panel
DB_USERNAME=pterodactyl
DB_PASSWORD=passwordKuat

CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis

REDIS_HOST=127.0.0.1
REDIS_PORT=6379

MAIL_DRIVER=smtp
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_ENCRYPTION=tls
[email protected]
MAIL_FROM_NAME="Pterodactyl Panel"

Cara Install Pterodactyl Panel & Wings — Panduan Lengkap 2026

Apa yang Akan Anda Bangun

Persyaratan Sistem

Keep Reading

Cara Install dan Menggunakan Termux di Android — Panduan Lengkap 2026

VPS OpenVZ Tidak Didukung

Panel dan Wings Bisa di Mesin Terpisah

Step 1: Update dan Install Dependensi

Untuk Debian

CentOS / Rocky Linux / RHEL

Step 2: Install Composer

Step 3: Setup Database

Gunakan Password yang Kuat!

Step 4: Download dan Install Panel

BACKUP APP_KEY Anda Sekarang!

Step 5: Konfigurasi Environment

Gunakan Redis untuk Semua Driver

Step 6: Migrasi Database dan Buat Admin

Jangan Interupsi Proses Migrasi

Step 7: Konfigurasi Web Server (Nginx + SSL)

Ganti Domain

Menggunakan Apache?

Step 8: Setup Cron Job dan Queue Worker

Panel Selesai! 🎉

Step 9: Install Docker untuk Wings

Hanya Linux

Step 10: Download dan Konfigurasi Wings

Allocations

Step 11: Jalankan Wings sebagai Service

Step 12: Konfigurasi Firewall dan Keamanan

SSL Panel = SSL Wings

Verifikasi Instalasi

Troubleshooting

Environment Variables Penting

Tips Keamanan

Langkah Selanjutnya

Selamat! 🎉