Deploy aplikasi Node.js Anda di hosting Rivervo (Next.js & Nuxt).
Banyak orang mengira aplikasi Node.js harus berjalan di VPS. Tidak juga — setiap paket shared hosting Rivervo punya Node.js dan Python di menu website, yang menjalankan proses Phusion Passenger untuk aplikasi Anda di belakang front-end Apache yang sama dengan yang melayani website Anda yang lain.
Panduan ini membahas seluruh alurnya untuk dua framework paling umum: Next.js dan Nuxt 3. Hasil akhirnya: aplikasi Anda di https://domainanda.co.id (atau subdomain mana pun), berjalan di proses Node.js sungguhan, tetap hidup setelah reboot, dan bisa dimulai ulang dengan satu klik.
Jika Anda belum pernah deploy aplikasi Node ke shared hosting, bagian yang paling sering membuat orang tersangkut adalah file awal — Passenger butuh satu skrip entry yang menjalankan framework Anda. Kami sediakan satu untuk masing-masing framework di bawah; tinggal salin-tempel, tanpa perlu diubah.
Yang Anda perlukan sebelum mulai
- Paket hosting Rivervo (paket apa pun — aplikasi Node.js berjalan di semua paket)
- Node.js v20 atau lebih baru di komputer lokal untuk build aplikasi
- Hasil build yang siap diunggah (kita bahas per framework)
- Akses File Manager atau SFTP ke akun Anda (keduanya bisa)
Anda tidak perlu root, sudo, systemd, atau konfigurasi reverse proxy. Semua itu ditangani Passenger.
Langkah 1 — Build aplikasi di komputer lokal
Yang Anda unggah adalah aplikasi yang sudah di-build, bukan source code. Panel menginstal dependensi, tetapi tidak mengompilasi React atau menjalankan build Vite. Lakukan itu di komputer Anda lebih dulu.
Next.js:
npm ci
npm run buildHasilnya .next/ (output build). Jangan jalankan next start di sini — sebentar lagi kita menjalankannya dari file awal.
Nuxt 3:
npm ci
npm run buildHasilnya .output/ (direktori build universal Nuxt). Sama seperti tadi — jangan jalankan apa pun dulu.
Langkah 2 — Unggah file yang tepat
Anda tidak perlu mengunggah node_modules/. Panel menginstal dependensi untuk Anda. Git dan cache build juga tidak perlu.
Unggah ke akun Anda, sebaiknya ke path di luar public_html (misalnya /home/<akun>/myapp/). Mengapa di luar? Karena Passenger otomatis memasang public_html di root URL, dan menaruh kode aplikasi di sana membuatnya terekspos.
| Framework | Unggah ini | Lewati |
|---|---|---|
| Next.js | .next/, public/, package.json, package-lock.json, next.config.js, server.cjs Anda (di bawah) | node_modules/, .git/, .env.local |
| Nuxt 3 | .output/, package.json, package-lock.json, server.cjs Anda (di bawah) | node_modules/, .nuxt/, .git/, source pages/, components/ |
Dua cara memindahkan file ke sana:
- Website → File → unggah zip → ekstrak adalah cara termudah jika koneksi Anda tidak stabil.
- SFTP (FileZilla, Cyberduck,
rsync) lebih cepat untuk deploy berulang. Server, port, user, dan kata sandi ada di Website → SSH dan SFTP.
Langkah 3 — Tambahkan file awal
Inilah file yang dijalankan Passenger saat ada request masuk. Taruh di sebelah package.json di folder aplikasi Anda.
Untuk Next.js — server.cjs
const next = require('next')
const http = require('http')
const port = process.env.PORT || 3000
const dev = process.env.NODE_ENV !== 'production'
const app = next({ dev, dir: __dirname })
const handle = app.getRequestHandler()
app.prepare().then(() => {
http.createServer((req, res) => handle(req, res)).listen(port, () => {
console.log(`Next.js server listening on port ${port}`)
})
})Yang dilakukannya:
- Memuat Next dan mengarahkannya ke direktori saat ini (tempat
.next/danpackage.jsonAnda berada). - Membuat request handler dari router internal Next.
- Menjalankan server HTTP di port yang diberikan Passenger (
process.env.PORT). - Memakai
3000sebagai cadangan untuk pengujian lokal.
dev otomatis ditentukan dari NODE_ENV — pilih mode Produksi di panel (kita lakukan di Langkah 4) dan Next berjalan dalam mode produksi.
Untuk Nuxt 3 — server.cjs
import('./.output/server/index.mjs').then(({ createApp }) => {
createApp().then(({ app }) => {
const port = process.env.PORT || 3000
app.listen(port, () => {
console.log(`Nuxt server listening on port ${port}`)
})
})
})Yang dilakukannya:
- Mengimpor secara dinamis
.output/server/index.mjsmilik Nuxt (entry yang dihasilkannpm run build). - Memakai
createApp()untuk membuat instance server H3. - Mendengarkan di port yang diberikan Passenger.
import() dinamis ini disengaja — modul .mjs tidak bisa di-require(), tetapi file .cjs bisa mengimpornya secara dinamis. Ini pola paling rapi yang berjalan di launcher Passenger.
Langkah 4 — Buat aplikasi di panel
Buka proyek Anda → Website → Node.js dan Python → Aplikasi Node.js.
| Kolom | Nilai |
|---|---|
| Versi | 20 atau lebih baru |
| Mode | Produksi |
| Folder | myapp di folder home Anda (tempat Anda mengunggah file) |
| Alamat | domainanda.co.id (atau subdomain seperti app.domainanda.co.id) |
| File awal | server.cjs |
Klik Buat. Lingkungan Node.js dibuat di ~/nodevenv/myapp/20/.
Instal dependensi
Setelah aplikasi dibuat, klik Instal dependensi (npm install) pada aplikasi itu dan perhatikan output-nya. Jika gagal:
- Pastikan
package.jsonada di root aplikasi (bukan di dalam subfolder). - Untuk Next.js: pastikan
nextada didependencies, bukandevDependencies(instalasi produksi melewati dependensi dev). - Untuk Nuxt:
nuxtsendiri juga harus menjadi dependensi biasa.
Tambahkan variabel lingkungan
Pengaturan aplikasi → Variabel lingkungan → Tambah variabel. Mode Produksi sudah mengatur NODE_ENV=production.
Untuk aplikasi Next.js yang membaca nilai saat runtime (URL database, API key), tambahkan di sini. Jangan sertakan file .env berisi rahasia — variabel lingkungan aplikasi adalah tempat yang tepat.
Menyimpan pengaturan akan memulai ulang aplikasi, jadi variabel baru langsung berlaku.
Langkah 5 — Verifikasi
Buka URL aplikasi Anda. Aplikasi Anda seharusnya tampil.
Jika muncul halaman error Passenger, buka detailnya dan lihat bagian bawah — hampir selalu ada stack trace yang jelas. Dua yang paling umum:
Error: Cannot find module 'next' — npm install tidak berjalan, atau berjalan di folder yang salah. Klik lagi Instal dependensi (npm install).
Error: ENOENT: no such file or directory, open '.next/...' — Anda mengunggah source code tetapi tidak menyertakan direktori .next/ hasil build. Build di komputer lokal lalu unggah ulang.
Cara deploy pembaruan
Ulangi langkah 1 dan 2, lalu klik Mulai ulang pada aplikasi. Rinciannya:
1. Build locally npm run build
2. Upload .next/ or .output/, plus any changed source/config
3. Panel Restart the appJika Anda mengubah package.json, klik Instal dependensi (npm install) sebelum memulai ulang. Lebih suka command line? Website → Terminal: kartu aplikasi menampilkan perintah untuk masuk ke lingkungannya.
Jebakan umum
WebSocket: Passenger menangani HTTP/1.1 dan HTTP/2. Upgrade WebSocket berfungsi untuk route bawaan Next.js dan Nuxt. Jika Anda memakai server WebSocket terpisah (ws, socket.io), server itu berbagi port yang sama dan dijalankan lewat server.cjs yang sama — tanpa konfigurasi tambahan.
Unggahan file / batas body-parser di next.config.js: batas default ukuran body request di Passenger adalah 10 MB. Jika Anda mengunggah file besar, naikkan passenger_max_request_size lewat .htaccess di public_html:
PassengerMaxRequestSize 52428800(50 MB dalam byte.)
Cron job: jika aplikasi Anda butuh tugas latar belakang (pengiriman newsletter, ekspor terjadwal), jangan jalankan di dalam proses web. Gunakan Website → Cron job untuk menjalankan skrip Node secara langsung:
/home/<akun>/nodevenv/myapp/20/bin/node /home/<akun>/myapp/scripts/send-newsletter.jsMemori proses: Passenger memulai ulang aplikasi Anda jika melebihi batas RAM per akun (tergantung paket Anda). Untuk aplikasi Next.js / Nuxt biasa, pemakaian saat idle di bawah 100 MB. Jika Anda mencapai batas, lakukan profiling dengan process.memoryUsage() dan cari kebocoran memori sebelum menyimpulkan Anda butuh paket lebih besar.
Domain kustom dan HTTPS: alamat yang Anda atur untuk aplikasi adalah yang di-bind oleh Passenger. SSL otomatis — tanpa konfigurasi tambahan. Untuk domain lain atau subdomain, tambahkan dulu di Website → Domain, lalu pilih sebagai alamat aplikasi.
Versi Node: daftar Versi menampilkan semua versi yang terinstal; ganti di Pengaturan aplikasi.
Kapan tidak memakai shared hosting untuk Node
Terus terang saja — Node.js di shared hosting sangat cocok untuk website portofolio, blog, halaman marketing, front-end SaaS kecil, dan tool internal. Yang kurang cocok:
- API dengan throughput tinggi (>50 req/detik terus-menerus) — batas CPU per akun akan terasa
- Aplikasi yang banyak memakai WebSocket dengan ribuan koneksi bersamaan
- Aplikasi yang menjalankan proses worker (queue worker, scraper) — batas proses per akun di Passenger membuatnya merepotkan
- Apa pun yang butuh systemd, Docker, atau akses root
Untuk itu, VPS kami adalah pilihan yang tepat — root penuh, kernel sendiri, menjalankan apa pun yang Anda mau. Tetapi untuk sebagian besar aplikasi Next.js dan Nuxt yang trafiknya tidak raksasa, panduan ini sudah cukup.
Ringkasnya
npm run builddi komputer lokal- Unggah
.next/(Next) atau.output/(Nuxt) +package.json+server.cjs - Website → Node.js dan Python → Aplikasi Node.js → folder, file awal
server.cjs, mode Produksi - Instal dependensi (npm install), lalu Mulai ulang
Jika ada yang tidak beres, buka tiket — tempelkan halaman error Passenger dan kami tunjukkan baris penyebabnya.
— Tim Rivervo