A. Pendahuluan

EmDash CMS merupakan salah satu Content Management System modern yang dibangun menggunakan teknologi berbasis JavaScript (Node.js). Platform ini dirancang untuk fleksibilitas tinggi serta kemudahan pengelolaan konten berbasis API.

Pada artikel ini akan dijelaskan langkah-langkah instalasi EmDash CMS pada sistem operasi Ubuntu 24.04, mulai dari persiapan dependensi hingga proses deployment agar aplikasi dapat diakses secara optimal.

Panduan ini ditujukan bagi pengguna yang memiliki akses root atau sudo pada server serta pemahaman dasar mengenai penggunaan terminal Linux.

B. Langkah-Langkah

Panduan ini menjelaskan proses installasi EMDash pada VPS Ubuntu 24 hingga dapat diakses menggunakan IP public VPS.

Panduan ini menggunakan:

• Ubuntu 24.04
• Node.js LTS
• PNPM
• PostgreSQL (opsional)
• Akses melalui IP VPS
• Mode development/self-hosted

1. Persiapan Sistem

Login ke VPS menggunakan SSH:

ssh root@IP_VPS

Update package Ubuntu:

apt update && apt upgrade -y

Install package dasar:

sudo apt install -y curl git build-essential ca-certificates gnupg

2. Install Node.js LTS

Tambahkan repository NodeSource:

curl -fsSL https://deb.nodesource.com/setup_lts.x -o nodesource_setup.sh

Install Node.js:

sudo bash nodesource_setup.sh

sudo apt install -y nodejs

Verifikasi:

node -v
npm -v

3. Install PNPM

Install PNPM secara global:

npm install -g pnpm

Verifikasi:

pnpm -v

4. Membuat Repository EMDash

Buat project baru:

npx create-emdash@latest

5. Install Dependency

Masuk ke direktori project:

cd my-site

Jalankan:

pnpm install

Jika muncul error:

ERR_PNPM_IGNORED_BUILDS

jalankan:

pnpm approve-builds

6. Approve Native Build Dependency

Saat menjalankan:

pnpm approve-builds

akan muncul daftar seperti:

○ better-sqlite3
○ esbuild
○ sharp

Pilih semua package:

• tekan a
• lalu ENTER

Kemudian jalankan:

pnpm rebuild

7. Membuat File Environment

Buat file .env:

nano .env

Isi contoh konfigurasi:

NODE_ENV=development

HOST=0.0.0.0
PORT=4321

ADMIN_TOKEN="emdash_admin_secure_token_"

NEXTAUTH_SECRET="emdash_nextauth_secret"

NEXTAUTH_URL=http://IP_ADDRESS:4321

Simpan:

CTRL + O

ENTER

CTRL + X

8. Membuka Firewall Port

Izinkan port aplikasi:

ufw allow 4321/tcp
ufw reload

9. Menjalankan EMDash

Jalankan:

pnpm dev --host 0.0.0.0

Jika berhasil akan muncul:

Local: http://localhost:4321

10. Mengakses EMDash

Buka browser:

http://IP_Address:4321

C. Kesimpulan

Instalasi EmDash CMS pada Ubuntu 24.04 dapat dilakukan dengan beberapa tahapan utama, yaitu persiapan environment, instalasi dependensi, konfigurasi aplikasi, serta deployment menggunakan process manager dan reverse proxy.

Dengan mengikuti panduan ini, aplikasi EmDash CMS diharapkan dapat berjalan dengan stabil dan siap digunakan dalam lingkungan produksi maupun pengembangan.

Apabila dalam proses instalasi ditemukan kendala, disarankan untuk melakukan pengecekan pada log aplikasi atau service manager seperti PM2 guna mengetahui penyebab error secara lebih spesifik.

Semoga artikel yang telah kami sampaikan dapat membantu Anda. Anda juga dapat menemukan artikel lainnya melalui halaman Knowledge Base Biznet Gio. Jika Anda masih memiliki kendala teknis terkait dengan layanan Biznet GIO, Anda dapat menghubungi kami melalui  email support@biznetgio.com atau dapat melalui live chat di website Biznet GIO, melalui chat WhatsApp dan bisa juga melalui telepon ke nomor (021) 5714567.