Dokumentasi Deploy Framework Next.js

Cara Hosting Aplikasi Next.js

Hostifame mendukung penuh ekosistem Server-Side Rendering (SSR) Next.js. Aplikasi Anda tidak hanya dijadikan web statis, melainkan dijalankan secara aktif sebagai Service Node.js di latar belakang menggunakan PM2 Process Manager.


1. Persiapkan File Proyek (.ZIP)

Hostifame menyediakan dua jalur cepat untuk deployment Next.js. Silakan pilih metode yang paling sesuai untuk Anda sebelum mengompres (zip) proyek Anda:

Metode Standar

Metode Auto-Build

Upload source code Next.js Anda apa adanya. Sistem kami akan menjalankan npm install dan npm run build untuk memproses kode Anda di server kami.

Wajib: Jangan ikut sertakan folder node_modules ataupun .next ke dalam file ZIP!
Sangat Cepat

Metode Pre-Built (Fast Deploy)

Jika Anda sudah menjalankan npm run build di laptop Anda, cukup kompres folder proyek beserta folder .next di dalamnya.

Sistem akan membaca folder .next Anda, melompati kompilasi build, dan web langsung menyala!

2. Formulir & Database Pintar (Prisma/ORM)

Saat Anda menambahkan proyek di Dasbor Hostifame dan mengisi formulir Informasi Database, mesin kami tidak hanya membuatkan MySQL untuk Anda. Sistem kami secara otomatis akan menyuntikkan file .env.local yang berisi kredensial siap pakai untuk ORM modern seperti Prisma atau Drizzle.

.env.local (Otomatis Dibuat Sistem)
# Kredensial ini otomatis disuntikkan oleh Hostifame jika Anda mengisi form Database
DATABASE_HOST="127.0.0.1"
DATABASE_PORT="3306"
DATABASE_USER="user_nextjsanda"
DATABASE_PASSWORD="SandiRahasia123!"
DATABASE_NAME="db_nextjsanda"

# Format URL siap pakai untuk Prisma ORM / Sequelize / Drizzle:
DATABASE_URL="mysql://user_nextjsanda:SandiRahasia123!@127.0.0.1:3306/db_nextjsanda"

3. Sihir Otomatisasi (Di Belakang Layar)

Setelah Anda mengklik Deploy, Anda bisa duduk santai. Server akan mengambil alih seluruh beban kerja infrastruktur kelas *Enterprise*:

Kompilasi & Optimasi

Menjalankan instalasi NPM dan npm run build (lengkap dengan bypass IPv4 DNS untuk kestabilan).

PM2 Process Manager

Menyalakan aplikasi Node.js Anda di latar belakang pada port khusus dan terisolasi agar web terus hidup 24/7 (Always-On).

Nginx Reverse Proxy

Nginx otomatis menyambungkan domain publik Anda ke port internal PM2 milik Anda tanpa Anda perlu mengatur konfigurasi server.

Dukungan Fitur Penuh (Tanpa Batasan)

Karena menggunakan arsitektur Node.js murni, Anda bebas menggunakan seluruh fitur canggih Next.js! Mulai dari API Routes (/app/api), Server Actions, Middleware, hingga komponen next/image akan berjalan sempurna tanpa perlu mematikan optimasi gambar.

4. Konfigurasi Environment & Restart Service

Jika Anda perlu menambah atau merubah variabel lingkungan (misalnya Token API eksternal), Anda bisa membuat/mengedit file .env menggunakan fitur Web File Manager.

Peringatan: PM2 Service Restart

Setiap kali Anda merubah isi dari file .env atau .env.local di File Manager, Node.js tidak akan membaca perubahannya secara otomatis.

Agar variabel baru Anda terbaca, Anda wajib merestart service Anda dengan menekan tombol NPM Run Build atau tombol eksekusi yang tersedia pada menu Pengembangan Cepat di Dasbor proyek Anda!