Dari proyek lokal
ke website yang online.

Pilih jalur yang didukung hosting.

cPanel adalah panel pengelolaan hosting. Ketersediaan Node.js, Passenger, PHP-CGI, dan akses folder privat bergantung pada paket serta konfigurasi penyedia Anda.

Website Nex ini menggunakan view PHP. Jika memilih target Node, PHP-CGI tetap diperlukan. Node tidak menerjemahkan PHP menjadi JavaScript. Hosting statis saja tidak dapat menjalankan proyek ini.

Konfirmasi ke penyedia hosting

• Apakah Node.js 22+ dan menu aplikasi tersedia?
• Apakah aplikasi Node diizinkan menjalankan child process PHP-CGI? Di mana lokasi executable yang benar?
• Apakah runtime dapat membaca folder privat dan menulis ke direktori storage/database milik aplikasi?
• Bagaimana Passenger, reverse proxy, HTTPS, dan log aplikasi dikelola pada akun Anda?

Tutorial ini menjelaskan konfigurasi. Membuka halaman ini tidak mengekspor file, mengakses akun cPanel, atau menerbitkan website secara otomatis.

Siapkan paket deployment yang benar.

1. Simpan semua perubahan source dan uji route penting dengan nex dev secara lokal.
2. Buka File → Export hosting ZIP. Ini berbeda dari Export sheet terpisah.
3. Pilih Node native Nex (node-nex) atau PHP/Apache (php-apache) sesuai hasil pemeriksaan hosting.
4. Gunakan Base URL / untuk root domain/subdomain. Untuk https://example.com/nex/, gunakan /nex/ dan cocokkan path aplikasi pada hosting.
5. Periksa laporan kompatibilitas. Untuk aplikasi database, sertakan hanya backend alias/salinan NexSQL yang memang dibutuhkan dan sudah disiapkan di aplikasi.
6. Pilih tujuan penyimpanan ZIP, lalu baca PANDUAN-HOSTING.md, INSTALL.md, serta deployment-report.json yang sesuai paket tersebut.

Melalui MCP, nex_hosting_plan dapat memeriksa target, kebutuhan, revisi dan tutorial tanpa mengembalikan source atau rahasia. Pembuatan ZIP serta pemilihan lokasinya tetap melalui UI aplikasi.

ZIP adalah arsip biasa yang membawa konfigurasi dan kunci deployment privat; ZIP tidak diberi password secara otomatis. Simpan dan transfer secara privat. Jangan menaruh ZIP atau folder privat pada URL publik.

Unggah seluruh paket ke folder privat.

Contoh berikut untuk target Node native. Di cPanel, buka File Manager, masuk ke home akun, lalu buat folder aplikasi di luar document root publik.

/home/USERNAME/nexsite/
├── app.js                    # startup aplikasi Node
├── package.json              # npm start
├── public_html/              # adapter PHP dari paket
├── nex-private-XXXXXXXX/     # nama aktual mengikuti ZIP
│   ├── containers/           # .nexcl / .nexsv terenkripsi
│   └── ...                   # runtime & konfigurasi privat
├── INSTALL.md
├── PANDUAN-HOSTING.md
└── deployment-report.json

1. Upload ZIP ke folder privat tersebut dan pilih Extract.
2. Pastikan app.js dan package.json langsung berada di application root, bukan satu subfolder tambahan.
3. Aktifkan Settings → Show Hidden Files untuk melihat .htaccess jika diperlukan.
4. Pertahankan nama dan hubungan folder dalam paket. Simpan salinan ZIP secara privat atau hapus salinan upload setelah ekstraksi dan verifikasi.

Untuk target Node, jangan memindahkan hanya isi public_html ke domain. Passenger menjalankan app.js dari application root; public_html/index.php di paket Node adalah adapter PHP-CGI, bukan startup Node.

Jika Node/PHP berjalan sebagai akun yang sama, folder privat umumnya dapat memakai 0700 dan file kunci/config 0600. Sesuaikan akses user/group dengan penyedia hosting; jangan memakai 0777 sebagai jalan pintas.

Isi form aplikasi di cPanel.

Pada CloudLinux, buka Software → Setup Node.js App → Create Application. Pada cPanel yang memakai Application Manager, daftarkan aplikasi yang telah diunggah dan cocokkan domain, application path, serta deployment environment. Kedua antarmuka berbeda; ikuti opsi yang tersedia pada hosting Anda.

1. Pastikan domain/subdomain sudah tercatat pada menu Domains dan DNS mengarah ke hosting.
2. Isi form lalu klik Create atau Deploy/Register sesuai panel.
3. Pada Application Manager, jika tidak ada field startup, pastikan app.js ada di application path. Untuk startup kustom, ikuti konfigurasi Passenger penyedia.
4. Lanjutkan mengisi environment, lalu simpan dan restart aplikasi.

Launcher Nex menggunakan modul bawaan Node; tidak membutuhkan npm install untuk dependency eksternal. Gunakan tombol Start/Restart milik panel. Jangan menjalankan proses npm start tambahan jika Passenger sudah mengelola aplikasi.

Atur environment untuk proses hosting.

Pada halaman konfigurasi aplikasi, gunakan Environment variables → Add Variable. Masukkan Name dan Value sebagai field terpisah.

Klik Save, lalu Restart. Variabel yang Anda set melalui perintah export di Terminal hanya berlaku untuk sesi shell tersebut, bukan otomatis untuk proses Passenger.

Periksa versi PHP-CGI jika Terminal tersedia

Sesuaikan path dengan informasi penyedia, lalu jalankan:

/opt/cpanel/ea-php84/root/usr/bin/php-cgi -v

Hasil harus menunjukkan SAPI cgi-fcgi, bukan cli, dengan PHP 8.2+ dan dukungan OpenSSL. Mengubah versi pada MultiPHP Manager tidak otomatis mengubah path PHP-CGI aplikasi Node.

Environment runtime server berbeda dari input publik website. Jangan menyalin password, token, isi nexsh, config privat atau kunci deployment ke contoh tutorial, screenshot publik, maupun chat AI.

Menggunakan target PHP/Apache.

Gunakan bagian ini hanya jika ZIP diekspor sebagai php-apache. Jangan mencampur petunjuk ini dengan paket target Node.

1. Pastikan PHP 8.2+ dan OpenSSL aktif. Gunakan MultiPHP Manager atau PHP Selector yang disediakan hosting untuk memilih versi domain.
2. Extract paket di lokasi privat. Pertahankan folder nex-private-<id> di luar document root domain.
3. Tempatkan isi direktori publik hasil ekspor (index.php dan .htaccess) di document root domain/subdomain yang benar.
4. Pastikan path privat pada loader sesuai lokasi folder. Untuk layout kustom, sesuaikan hanya referensi $private menurut INSTALL.md paket. Jangan memindahkan kunci ke area publik.
5. Pastikan rewrite Apache/LiteSpeed aktif, .htaccess ikut terunggah, dan open_basedir mengizinkan akses ke folder privat.
6. Aktifkan HTTPS dan periksa route serta asset seperti langkah pengujian berikut.

/home/USERNAME/
├── public_html/             # contoh document root
│   ├── index.php
│   └── .htaccess
└── nex-private-XXXXXXXX/     # privat, tidak dapat diunduh publik

Nama document root subdomain dapat berbeda dari public_html. Gunakan lokasi aktual yang terlihat di cPanel Domains. Untuk Base URL subfolder, ikuti layout dan referensi path pada panduan paket.

Nginx/IIS memerlukan pengaturan front-controller oleh administrator; keberadaan PHP saja tidak menjamin aturan Apache dapat dipakai.

Verifikasi dari domain publik.

1. Buka domain HTTPS Anda, misalnya https://nex.example.com/. Alamat 127.0.0.1 pada server adalah alamat internal, bukan URL untuk pengunjung.
2. Uji beranda, /panduan, /unduh, dan /panduan/hosting untuk website ini. Pastikan tombol Unduh tetap nonaktif karena rilis belum tersedia.
3. Uji CSS/JavaScript, menu ponsel, tab contoh kode, pencarian panduan dan salin kode. Refresh juga route selain root.
4. Jika aplikasi memakai akun/database, uji login, cookie HTTPS, akses role, CSRF, dan baca/tulis data pada lingkungan uji yang sesuai.
5. Pastikan ZIP, folder privat, config, nexsh, container dan database tidak bisa diambil lewat HTTP. Periksa status penolakan tanpa membagikan isi atau screenshot rahasia.
6. Periksa log melalui cPanel atau akses privat. Aktifkan pemantauan dan backup sesuai kebutuhan proyek.

Proyek PHP/MVC pada target Node memiliki batas adapter: 4 request PHP serentak, body 8 MB, dan timeout 30 detik. Uji kapasitas berdasarkan penggunaan nyata; berhasil di lokal tidak menjamin semua shared hosting kompatibel.

Perbarui source tanpa menimpa data.

1. Cadangkan paket produksi, kunci/config, database, upload dan storage melalui mekanisme privat yang dapat dipulihkan.
2. Uji paket baru pada staging. Gunakan satu set container/runtime/config yang konsisten dengan hasil ekspor.
3. Tinjau apakah paket membawa salinan database lokal. Jangan mengganti database produksi dengan snapshot lokal tanpa rencana migrasi yang memang diperlukan.
4. Jaga izin folder, environment, backend alias, dan hubungan kunci-container saat deployment. Berkas upload/storage/SQL lama perlu dipindahkan melalui rencana terpisah bila dibutuhkan.
5. Restart aplikasi Node melalui panel sesudah update, lalu ulangi pengujian. Untuk PHP/Apache, periksa pemuatan runtime sesuai mekanisme provider.
6. Jika verifikasi gagal, pulihkan backup yang sesuai. Jangan menonaktifkan autentikasi atau guard Host/Origin untuk menutupi masalah deployment.

Database lokal dan hosting tidak tersinkron otomatis. Ekspor source bukan backup lengkap untuk semua data runtime produksi.

Mulai dari gejala yang terlihat.

Jika meminta bantuan penyedia, sebutkan domain, waktu kejadian, status HTTP dan ringkasan log yang sudah disanitasi. Hapus password, token, cookie session, kunci dan isi konfigurasi privat.

Gunakan panduan paket sebagai acuan.

Persyaratan dan format Nex pada halaman ini merujuk dokumentasi exporter Nex serta tutorial dari nex_hosting_plan. INSTALL.md dan PANDUAN-HOSTING.md dalam ZIP memuat nama folder dan Base URL paket Anda.

• cPanel: membuat aplikasi Node.js melalui CloudLinux ↗
• cPanel: Application Manager dan environment variables ↗
• CloudLinux: Node.js Selector ↗

Dokumentasi antarmuka diperiksa pada 13 November 2026. Menu, versi dan izin dapat berbeda menurut penyedia. Website ini tidak mengakses cPanel atau menyimpan kredensial hosting.