Dari instalasi sampai
operasional harian.

01 / Sebelum mulai

Gunakan Ubuntu Server 22.04 LTS pada VPS baru. Versi Ubuntu dan distro lain belum didukung installer ini.

• Gunakan VPS baru dengan akses sudo atau root dan konsol pemulihan dari penyedia VPS.
• Domain tidak wajib. Panel dapat diakses melalui IP publik VPS pada HTTPS port 8888.
• Gunakan 2 vCPU, RAM 2 GB, dan ruang kosong 20 GB sebagai titik awal perencanaan, bukan minimum terukur. Tambahkan kapasitas sesuai database, runtime, dan aplikasi Anda.
• Pastikan koneksi internet VPS aktif dan port 8888/tcp diizinkan oleh firewall VPS serta penyedia.
• Ambil snapshot sebelum perubahan besar. Jangan memasang panel di server yang sudah menjalankan panel lain atau website penting tanpa rencana migrasi.

02 / Instalasi satu perintah

Jalankan di terminal SSH VPS baru dengan Ubuntu Server 22.04 LTS. Tidak perlu Git atau clone repository.

curl -fsS https://repos.thellnx.site/install.sh | sudo bash

1. Isi username, atau tekan Enter untuk memakai admin.
2. Isi dan konfirmasi password, atau tekan Enter untuk membuat password acak yang kuat.
3. Setelah selesai, terminal menampilkan link akses panel, username, dan password. Simpan kredensial di tempat aman.

Installer memasang dependensi, panel Free, HTTPS, dan pembaruan otomatis. Akses melalui https://IP-VPS:8888. Perintah berjalan sebagai root; pastikan port 8888/tcp terbuka.

Hanya untuk VPS baruJangan gunakan untuk instalasi ulang. Jika panel sudah terpasang, gunakan sudo tx update. Simpan snapshot sebelum perubahan server.

Tanpa domain, HTTPS menggunakan sertifikat lokal sehingga browser menampilkan peringatan. Cocokkan fingerprint sertifikat dengan yang ditampilkan terminal sebelum melanjutkan.

Untuk mengganti username atau password, jalankan sudo tx di terminal dan pilih menunya. Perintah langsung: sudo tx username atau sudo tx password.

curl -fsS https://repos.thellnx.site/install.sh | sudo bash -s -- --domain panel.example.com

sudo apt-get update && sudo apt-get install -y curl ca-certificates

sudo tx status
sudo systemctl status tx-panel --no-pager

git clone https://repos.thellnx.site/thellnx-panel.git thellnx-panel-source
cd thellnx-panel-source
sudo bash deploy/install-direct.sh

03 / Login dan langkah awal

1. Pastikan koneksi HTTPS valid, lalu login dengan akun administrator panel.
2. Pilih Bahasa Indonesia atau English pada toolbar. Pilihan bahasa juga berlaku pada modal Lisensi & Pembaruan.
3. Periksa Dasbor: CPU, RAM, disk, IP publik, layanan, dan uptime. Cocokkan IP dengan VPS Anda.
4. Buka Pengaturan untuk meninjau konfigurasi panel. Simpan password kuat di pengelola password, bukan file website.
5. Periksa Keamanan, aturan SSH, firewall, dan backup sebelum memasukkan data penting.

Jangan membagikan satu akun administrator kepada pengunjung website. Akun panel, akun database, dan akun Client Area mempunyai kegunaan berbeda.

04 / Website, runtime, dan SSL

Membuat website

1. Arahkan DNS domain website ke VPS. Gunakan domain berbeda dari domain akses panel.
2. Di katalog aplikasi, pasang runtime yang diperlukan. Tunggu pemasangan selesai sebelum membuat project.
3. Buka menu Situs Web / Website dan tambah project. Pilih PHP, Node.js, Python, Go, atau reverse proxy sesuai aplikasi.
4. Isi domain, document root, dan versi runtime atau upstream yang diminta. Gunakan direktori aplikasi yang benar; jangan jadikan seluruh filesystem sebagai document root.
5. Upload source. Simpan environment dan secret di luar direktori publik sesuai framework. Untuk proses aplikasi, pastikan port upstream tidak dipakai layanan lain.
6. Aktifkan project dan periksa access/error log. Website harus dapat diakses sebelum memasang SSL.

Mengaktifkan HTTPS

1. Buka pengaturan SSL pada website, periksa domain dan DNS.
2. Terbitkan sertifikat Let's Encrypt. Port 80 harus dapat dijangkau untuk validasi yang digunakan.
3. Setelah sertifikat valid, aktifkan redirect HTTPS jika dibutuhkan.
4. Uji halaman, file statis, login aplikasi, dan mixed content. Tinjau status sertifikat secara berkala.

Versi PHP yang bisa dipilih mengikuti PHP-FPM yang benar-benar terpasang. Memasang webserver alternatif tidak otomatis memindahkan website atau membebaskan port 80/443.

05 / Membuat dan menggunakan database

1. Pasang engine database yang diperlukan dari katalog aplikasi. Menu Database menampilkan engine yang terdeteksi dan dapat digunakan.
2. Buat database serta user khusus aplikasi dengan password kuat.
3. Berikan akses hanya ke database aplikasi tersebut. Jangan memakai akun root database sebagai akun website.
4. Masukkan host, nama database, user, dan password pada konfigurasi privat aplikasi.
5. Uji koneksi sebelum migrasi atau import. Ekspor cadangan sebelum mengubah struktur atau menghapus database.

06 / File, backup, dan pemulihan

File Manager

Masuk ke direktori project, lalu upload atau edit file yang diperlukan. Periksa path, pemilik, dan permission. Hindari chmod 777 dan jangan mengubah direktori sistem jika tidak memahami dampaknya. Recycle Bin, jika digunakan oleh operasi tersebut, bukan pengganti backup.

Rutinitas backup

1. Buat cadangan website dan ekspor database sebelum deployment aplikasi.
2. Periksa tanggal, ukuran, serta isi hasil cadangan; arsip yang berhasil dibuat belum membuktikan data dapat dipulihkan.
3. Simpan salinan terenkripsi di luar VPS. Backup pada disk VPS yang sama tidak melindungi dari kehilangan VPS.
4. Uji restore pada server atau project uji. Jadwalkan downtime jika restore menimpa file atau database aktif.

Rollback updater memulihkan komponen panel ketika health check gagal. Itu bukan rollback seluruh VPS dan bukan jaminan pemulihan data website.

07 / Terminal dan perintah tx

Terminal panel menjalankan shell pada server yang dipilih. Periksa nama server dan direktori aktif sebelum mengetik. Simpan pekerjaan sebelum restart layanan atau update panel karena sesi terminal dapat terputus.

pwd
whoami
hostname

CLI installer production menyediakan perintah berikut. Jalankan dari SSH atau terminal yang memiliki akses root.

sudo tx di terminal membuka menu ganti username dan password. Gunakan sudo tx status untuk memeriksa status panel. Saat mengganti kredensial, sesi yang sudah aktif tidak dihentikan otomatis.

Hindari menempel perintah yang belum dipahami. Jangan memakai tx deploy atau tx publish pada VPS klien; perintah tersebut untuk penerbit rilis di lingkungan development.

08 / Firewall, SSH, dan WAF

Membuka port dengan sumber terbatas

1. Buka menu Keamanan dan aturan Firewall.
2. Pilih port serta protokol yang benar untuk layanan.
3. Pilih IP spesifik untuk membatasi sumber, atau ALL IP hanya jika layanan memang harus publik.
4. Untuk beberapa IP, pisahkan dengan koma, misalnya 203.0.113.10, 198.51.100.20. Angka ini hanya contoh dokumentasi; ganti dengan IP Anda.
5. Simpan, periksa aturan yang tercipta, lalu uji koneksi dari sumber yang diizinkan. Gunakan operasi Edit untuk mengubah aturan.

Proteksi website dan sistem

WAF dan pengaturan keamanan lanjutan tersedia dengan Pro aktif. Fitur dasar seperti firewall, SSH, SSL, backup, dan pembaruan panel tetap tersedia di Free. Pengaturan yang sudah ada tetap dipertahankan.

Proteksi tidak menjamin server bebas serangan. Rawat OS dan aplikasi, gunakan akses minimum, dan pertahankan backup yang sudah diuji.

09 / Pengaturan Codex di panel

1. Buka pengaturan Codex dan pilih metode autentikasi yang tersedia: Login ChatGPT atau OpenAI API key.
2. Selesaikan login sebelum memilih model dan menjalankan tugas. Jangan membagikan API key atau file kredensial terminal.
3. Pilih model yang ditampilkan oleh panel dan tingkat penalaran sesuai tugas.
4. Mulai dari mode Terbatas / Restricted untuk status, log, dan pemeriksaan read-only.
5. Gunakan Full Akses / root hanya jika diperlukan dan pahami bahwa tindakan dapat mengubah seluruh VPS. Pertahankan persetujuan aksi root.

Autentikasi, model, dan biaya layanan Codex/OpenAI terpisah dari lisensi Pro thellnx. Lisensi Pro bukan langganan ChatGPT atau saldo API.

Jika tombol pembaruan CLI tersedia, selesaikan tugas dan antrean terlebih dahulu. Saat pembaruan berlangsung, tunggu modal proses selesai; jangan mematikan layanan atau memulai pembaruan kedua.

10 / Free, Pro, dan Client Area

Fitur dasar dapat dipakai tanpa aktivasi Pro. Source panel tersedia di repository resmi. Pemilik belum menetapkan lisensi untuk source miliknya; publikasi source bukan pemberian hak penggunaan ulang atau redistribusi secara umum. Lisensi komponen pihak ketiga tetap berlaku. Repository tidak menyertakan backend akun dan pembayaran.

• Satu lisensi hanya untuk satu VPS aktif. Membutuhkan VPS tambahan berarti membutuhkan lisensi tambahan.
• Satu akun Client Area boleh memiliki beberapa lisensi; pembelian lisensi baru berbeda dari perpanjangan lisensi lama.
• License Key bersifat tetap. Penggantian VPS yang masih terikat memerlukan penanganan binding yang sesuai, bukan membagikan key ke server kedua.

Untuk akun dan lisensi yang sudah tersedia

1. Buka toolbar Lisensi & Pembaruan pada panel.
2. Hubungkan akun Client Area melalui alur login yang ditampilkan. Password tidak disimpan di VPS; sesi akun tetap terhubung sampai logout manual atau sesi dicabut.
3. Pilih License Key yang tersedia untuk VPS ini dan aktifkan.
4. Setelah berhasil, pilihan terkunci. Gunakan Buka kunci jika perlu mengganti, lalu pilih lisensi yang sesuai dan konfirmasi.
5. Lisensi lama tetap berlaku sampai penggantian berhasil. Membuka pilihan tidak membebaskan lisensi yang terikat di VPS lain.

Notifikasi kuning muncul saat masa langganan tersisa paling lama lima hari; merah saat berakhir. Lisensi seumur hidup tidak memiliki tanggal kedaluwarsa. Langganan berakhir tidak menghapus konfigurasi keamanan yang sudah ada.

Setelah pembayaran resmi dibuka, periksa status transaksi dan invoice dari Client Area. Transaksi berstatus pending bukan pembayaran berhasil; jangan mengulang pembelian hanya karena halaman pembayaran belum memberikan konfirmasi.

11 / Memperbarui panel

1. Pastikan backup dan akses SSH pemulihan tersedia.
2. Periksa apakah ada tugas Codex atau pemasangan aplikasi yang masih aktif. Selesaikan dahulu.
3. Buka Lisensi & Pembaruan. Panel memeriksa rilis secara berkala; notifikasi merah menandai pembaruan tersedia.
4. Baca bagian Yang baru di versi terbaru, lalu klik Periksa & perbarui.
5. Tunggu proses selesai. Panel dapat restart dan terminal dapat terputus. Jangan menganggap menutup browser membatalkan proses server.
6. Muat ulang halaman dan cocokkan versi panel serta status kesehatan.

sudo tx update
sudo systemctl status tx-panel --no-pager
sudo journalctl -u thellnx-update.service -n 80 --no-pager

Installer standar membuat timer thellnx-update.timer untuk pemeriksaan/pembaruan berkala dan thellnx-license.timer untuk sinkronisasi lisensi. Nama service dapat berbeda pada instalasi khusus multi-instance; cek konfigurasi instance sebelum memakai perintah administrasi.

Arsip rilis diverifikasi tanda tangan dan checksum-nya. Bila health check rilis baru gagal setelah pergantian, updater mencoba memulihkan kode dan database panel sebelumnya. Jangan mengganti checksum, melewati verifikasi, atau menghapus folder backup untuk memaksa update.

Yang baru di v1.0.5

• Peningkatan keamanan aktivasi dan verifikasi Pro.
• Pro memerlukan akun terhubung dan lisensi aktif untuk VPS ini.
• Aktivasi melalui pilihan lisensi akun Client Area.
• Fitur dasar dan pengaturan yang sudah ada tetap dipertahankan.

12 / Mengatasi kendala

sudo systemctl status tx-panel nginx --no-pager
curl -fsS http://127.0.0.1:8787/api/health
sudo nginx -t
sudo journalctl -u tx-panel -n 80 --no-pager

Referensi Ubuntu

Dasar pengelolaan paket dan pembatasan jaringan mengikuti dokumentasi resmi paket APT Ubuntu dan firewall UFW Ubuntu. Perintah aplikasi thellnx pada panduan ini diperiksa terhadap source installer dan panel yang tersedia.