Cara Instalasi Panel Pterodactyl di Ubuntu 24.04 Command Line: Panduan Terlengkap 2024

Mengelola server game secara manual melalui terminal seringkali menjadi tugas yang melelahkan dan rentan terhadap kesalahan. Bagi Anda yang ingin membangun komunitas gaming atau menyediakan layanan hosting server game, memiliki panel kontrol yang intuitif adalah sebuah keharusan. Dalam artikel ini, kita akan membahas secara mendalam mengenai cara instalasi panel pterodactyl di ubuntu 24.04 command line untuk membantu Anda membangun infrastruktur yang stabil, aman, dan berperforma tinggi.

Pterodactyl adalah panel kontrol open-source yang dibangun menggunakan PHP, React, dan Go, yang dirancang khusus untuk mengelola server game di dalam container Docker. Dengan menggunakan Ubuntu 24.04 LTS (Noble Numbat) sebagai basis sistem operasi, Anda mendapatkan dukungan jangka panjang dan stabilitas kernel terbaru yang sangat krusial untuk beban kerja server yang intensif.

Persyaratan Sistem dan Persiapan

Sebelum memulai proses cara instalasi panel pterodactyl di ubuntu 24.04 command line, pastikan server Anda memenuhi spesifikasi minimum agar panel dapat berjalan lancar tanpa kendala resource. Berdasarkan data teknis dari dokumentasi resmi, berikut adalah spesifikasi yang disarankan:

• CPU: 2 Cores atau lebih (Rekomendasi arsitektur KVM/Dedicated).
• RAM: Minimal 2GB (4GB direkomendasikan untuk performa optimal).
• Penyimpanan: Minimal 20GB SSD/NVMe.
• OS: Ubuntu 24.04 LTS (Fresh Install).
• Domain: Nama domain yang sudah diarahkan ke IP server (A Record) untuk akses Panel dan SSL.

Catatan: Sangat disarankan untuk menggunakan VPS yang bersih (Fresh Install) untuk menghindari konflik port atau versi library yang sudah ada sebelumnya.

Langkah 1: Update dan Upgrade Sistem Ubuntu

Langkah pertama dalam cara instalasi panel pterodactyl di ubuntu 24.04 command line adalah memastikan semua repositori dan paket sistem berada pada versi terbaru. Ini penting untuk keamanan dan kompatibilitas library.

Jalankan perintah berikut di terminal Anda:

sudo apt update && sudo apt upgrade -y

Setelah proses upgrade selesai, jika ada pembaruan kernel, sebaiknya lakukan reboot server dengan perintah sudo reboot untuk memastikan semua perubahan diterapkan.

Langkah 2: Instalasi Dependencies (PHP, MySQL, Nginx)

Pterodactyl membutuhkan tumpukan teknologi (stack) yang spesifik. Kita akan menggunakan PHP 8.3 (versi default di Ubuntu 24.04), MariaDB sebagai database, dan Nginx sebagai web server.

Gunakan perintah berikut untuk menginstal semua library yang diperlukan:

sudo apt install -y software-properties-common curl apt-transport-https ca-certificates gnupg
sudo apt install -y php8.3 php8.3-common php8.3-cli php8.3-gd php8.3-mysql php8.3-mbstring php8.3-bcmath php8.3-xml php8.3-fpm php8.3-curl php8.3-zip mariadb-server nginx tar unzip git redis-server

Setelah instalasi selesai, pastikan layanan Redis dan MariaDB berjalan otomatis saat boot:

sudo systemctl enable --now redis-server
sudo systemctl enable --now mariadb

Langkah 3: Instalasi Composer

Composer adalah dependency manager untuk PHP yang digunakan Pterodactyl untuk mengelola library internalnya. Untuk menginstalnya, jalankan perintah ini:

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

Verifikasi instalasi dengan mengetik composer --version. Pastikan tidak ada error yang muncul di layar terminal Anda.

Langkah 4: Download dan Setup File Pterodactyl

Sekarang kita masuk ke inti dari cara instalasi panel pterodactyl di ubuntu 24.04 command line. Kita akan membuat direktori kerja dan mengunduh source code resmi Pterodactyl.

sudo mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
sudo tar -xzvf panel.tar.gz
sudo chmod -R 755 storage/* bootstrap/cache/

Langkah di atas akan mengekstrak file panel ke direktori /var/www/pterodactyl dan mengatur izin dasar pada folder storage agar aplikasi dapat menulis log dan cache.

Langkah 5: Konfigurasi Database MariaDB

Pterodactyl membutuhkan database SQL untuk menyimpan data user, server, dan konfigurasi lainnya. Masuk ke prompt MariaDB:

sudo mysql -u root

Di dalam shell MariaDB, buat database dan user baru (ganti ‘password_anda’ dengan password yang kuat):

CREATE DATABASE panel;
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'password_anda';
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;

Langkah 6: Konfigurasi Environment dan Migrasi Database

Kembali ke direktori /var/www/pterodactyl, kita akan menyalin file environment dan menginstal semua library PHP melalui Composer:

cp .env.example .env
composer install --no-dev --optimize-autoloader

Setelah library terinstal, jalankan perintah berikut untuk menghasilkan enkripsi key dan mengonfigurasi database di file .env secara otomatis:

php artisan key:generate --force
php artisan p:environment:setup
php artisan p:environment:database

Selanjutnya, jalankan migrasi database untuk membuat tabel-tabel yang diperlukan:

php artisan migrate --seed --force

Terakhir, buat user administratif pertama Anda:

php artisan p:user:make

Ikuti instruksi di layar untuk mengisi email, username, dan password admin Anda.

Langkah 7: Konfigurasi Web Server Nginx

Agar panel dapat diakses melalui browser, kita perlu membuat file konfigurasi Nginx. Hapus konfigurasi default dan buat file baru:

sudo rm /etc/nginx/sites-enabled/default
sudo nano /etc/nginx/sites-available/pterodactyl.conf

Tempelkan konfigurasi berikut (ganti domain_anda.com dengan domain asli Anda):

server {
    listen 80;
    server_name domain_anda.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;

    # allow larger file uploads and longer script runtimes
    client_max_body_size 100m;
    client_body_timeout 120s;

    sendfile off;

    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;
    }
}

Aktifkan konfigurasi dan restart Nginx:

sudo ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf
sudo systemctl restart nginx

Langkah 8: Instalasi SSL dengan Let’s Encrypt

Keamanan adalah aspek vital dalam cara instalasi panel pterodactyl di ubuntu 24.04 command line. Jangan pernah menjalankan panel tanpa enkripsi HTTPS. Kita akan menggunakan Certbot untuk mendapatkan sertifikat SSL gratis.

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d domain_anda.com

Ikuti petunjuk di layar. Certbot akan secara otomatis memperbarui file konfigurasi Nginx Anda untuk mendukung HTTPS dan melakukan redirect otomatis dari HTTP ke HTTPS.

Langkah 9: Konfigurasi Queue Workers dan Cron

Pterodactyl menggunakan antrean (queue) untuk menangani tugas-tugas di latar belakang seperti pengiriman email dan pembuatan server. Kita perlu mengatur Cron dan Systemd worker.

Tambahkan cronjob dengan perintah sudo crontab -e -u www-data dan tempel baris berikut di bagian paling bawah:

* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1

Selanjutnya, buat file service untuk worker:

sudo nano /etc/systemd/system/pteroq.service

Isi dengan konten berikut:

[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

[Install]
WantedBy=multi-user.target

Aktifkan service tersebut:

sudo systemctl enable --now pteroq.service

Troubleshooting dan Tips Optimasi

Meskipun Anda telah mengikuti panduan cara instalasi panel pterodactyl di ubuntu 24.04 command line dengan benar, terkadang masalah teknis bisa muncul. Berikut adalah beberapa solusi untuk masalah umum:

• Error 500: Biasanya disebabkan oleh izin folder yang salah. Pastikan folder storage dan bootstrap/cache dimiliki oleh user www-data dengan menjalankan: sudo chown -R www-data:www-data /var/www/pterodactyl/*.
• Database Connection Refused: Periksa apakah MariaDB berjalan dan pastikan kredensial di file .env sudah sesuai dengan yang Anda buat di Langkah 5.
• Email Tidak Terkirim: Pastikan Anda telah mengonfigurasi SMTP di menu Settings pada panel admin Pterodactyl.

Untuk optimasi performa, pastikan Anda mengaktifkan OPcache pada PHP 8.3 untuk mempercepat eksekusi skrip PHP. Anda juga bisa meningkatkan batas memori PHP (memory_limit) menjadi minimal 512MB di file /etc/php/8.3/fpm/php.ini.

Kesimpulan dan Langkah Berikutnya

Selamat! Anda telah berhasil menyelesaikan seluruh proses cara instalasi panel pterodactyl di ubuntu 24.04 command line. Sekarang Anda memiliki panel kontrol server game yang modern, aman, dan siap digunakan. Dengan infrastruktur berbasis Ubuntu 24.04, panel Anda akan memiliki fondasi yang kuat untuk jangka waktu yang lama.

Langkah selanjutnya setelah instalasi panel adalah menginstal Wings. Wings adalah daemon yang bertugas menjalankan container Docker untuk setiap game server. Tanpa Wings, panel Anda hanyalah antarmuka tanpa mesin penggerak. Pastikan untuk membaca dokumentasi resmi Pterodactyl untuk konfigurasi node dan alokasi IP agar server game Anda dapat segera online.

Jika Anda merasa artikel ini bermanfaat, jangan ragu untuk membagikannya kepada rekan sesama sysadmin atau pemilik server game lainnya. Membangun infrastruktur server yang rapi adalah langkah awal menuju komunitas gaming yang sukses!