Pendahuluan
Next.js adalah framework React yang sangat populer untuk membangun website yang cepat dan SEO-friendly. Di DMG-Host, Anda dapat men-deploy aplikasi Next.js ke cPanel hosting menggunakan metode Static Export. Metode ini mengubah aplikasi Anda menjadi file HTML/CSS/JS statis yang sangat ringan dan stabil.
Langkah-langkah Deploy Next.js (Static Export):
-
Konfigurasi Next Config: Sebelum melakukan build di komputer lokal, Anda harus mengaktifkan mode export. Buka file
next.config.jsataunext.config.mjsdi project Anda dan tambahkan baris berikut:const nextConfig = {
output: 'export',
// Optional: Tambahkan jika asset tidak muncul
// images: { unoptimized: true },
}; -
Proses Build di Lokal: Jalankan perintah build di terminal komputer Anda. Perintah ini akan menghasilkan folder bernama
outyang berisi file siap upload.npm run build -
Upload ke cPanel:
- Masuk ke File Manager cPanel.
- Buka direktori
public_html(atau folder subdomain Anda). - Kompres isi folder
out(bukan folder luarnya) menjadi format ZIP. - Upload dan ekstrak file ZIP tersebut ke dalam
public_html.
-
Penanganan Pretty URLs (PENTING): Agar halaman seperti
domain.com/aboutbisa diakses tanpa error 404, buat atau edit file.htaccessdi folderpublic_htmldan masukkan kode berikut:RewriteEngine On
RewriteCond %{DOCUMENT_ROOT}/$1.html -f
RewriteRule ^([^/]+)/?$ $1.html [L]
Hal Penting yang Perlu Diketahui:
- Fitur Server-Side: Metode Static Export tidak mendukung fitur Server-side Rendering (SSR) atau API Routes bawaan Next.js yang berjalan di sisi server Node.js. Jika Anda butuh fitur tersebut, silakan hubungi kami untuk paket VPS DMG.
- Image Optimization: Karena berjalan sebagai file statis, fitur
next/imagebawaan memerlukan konfigurasiunoptimized: truedi config jika Anda tidak menggunakan penyedia optimasi gambar eksternal. - Dukungan DMG-Host: Jika Anda mengalami kendala terkait routing atau asset yang tidak muncul setelah deploy, tim teknis DMG-Host siap membantu Anda melalui sistem tiket.