Cara Menginstal Directus di Ubuntu 24.04

Directus adalah backend fleksibel yang memungkinkan Anda untuk mengubah basis data Anda menjadi CMS headless, panel admin, atau aplikasi dengan UI kustom, API instan, dan lebih banyak lagi. Dalam tutorial ini, kita akan membahas langkah-langkah untuk menginstal Directus di Ubuntu 24.04.

Prasyarat

• Server dengan Ubuntu 24.04 terinstal.
• Hak akses root atau sudo untuk menginstal paket perangkat lunak.
• Node.js dan npm terinstal. Pastikan versinya adalah 14.x atau lebih baru.
• Database (MySQL, PostgreSQL, atau SQLite) terinstal dan dikonfigurasi.
• PM2 (proses manajer untuk Node.js) untuk mengelola aplikasi Directus.

Langkah Utama

Mari kita mulai dengan menginstal Directus. Ikuti langkah-langkah berikut:

1. Memperbarui Sistem

sudo apt update && sudo apt upgrade -y

Pertama-tama, pastikan sistem Anda diperbarui dengan menjalankan perintah di atas. Ini akan menginstal semua pembaruan terbaru untuk paket perangkat lunak yang terpasang.

2. Instal Node.js dan npm

curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt install -y nodejs

Instal Node.js versi 14.x dan npm menggunakan perintah di atas. Anda dapat memeriksa instalasi dengan perintah:

node -v
npm -v

3. Instal PM2

sudo npm install -g pm2

PM2 akan membantu Anda menjalankan Directus sebagai proses latar belakang. Instal dengan perintah di atas, kemudian periksa bahwa PM2 sudah terinstal dengan:

pm2 -v

4. Membuat Proyek Directus Baru

npx create-directus-project my-project

Gunakan perintah di atas untuk membuat proyek Directus baru. Gantilah my-project dengan nama proyek Anda. Selama proses ini, Anda akan diminta untuk mengkonfigurasi koneksi database.

5. Menjalankan Proyek Directus

cd my-project
npm install
pm2 start npm --name "directus" -- start

Berpindahlah ke direktori proyek dan instal dependensi. Setelah itu, jalankan aplikasi menggunakan PM2.

Konfigurasi Lanjutan

Setelah Directus berjalan, Anda mungkin ingin mengkonfigurasi beberapa pengaturan tambahan untuk meningkatkan performa dan keamanan aplikasi.

1. Konfigurasi PM2 untuk Otomatisasi

pm2 startup
pm2 save

Untuk memastikan aplikasi Anda berjalan otomatis setelah restart server, jalankan perintah di atas. Ini akan mengkonfigurasi PM2 untuk startup dan menyimpan konfigurasi yang ada.

2. Mengatur Variabel Lingkungan

Buka file config/.env di dalam direktori proyek Anda untuk mengatur variabel lingkungan seperti:

DATABASE_URL=mysql://user:password@localhost:3306/mydatabase

Pastikan Anda mengganti user, password, dan mydatabase sesuai dengan pengaturan database Anda.

Best Practices

Berikut adalah beberapa praktik terbaik untuk memastikan instalasi Directus berjalan lancar:

• Selalu gunakan versi terbaru dari Node.js dan npm untuk mendapatkan fitur terbaru dan perbaikan keamanan.
• Backup database secara rutin untuk menghindari kehilangan data.
• Gunakan HTTPS untuk melindungi data yang ditransmisikan antara server dan klien.
• Monitor penggunaan sumber daya server untuk mengidentifikasi potensi masalah performa.

Troubleshooting

Jika Anda mengalami masalah saat instalasi atau saat aplikasi berjalan, berikut beberapa langkah pemecahan masalah:

• Periksa log aplikasi dengan perintah pm2 logs directus untuk melihat pesan kesalahan.
• Pastikan semua dependensi telah terinstal dengan baik tanpa kesalahan.
• Cek konfigurasi database di file .env untuk memastikan koneksi berhasil.
• Jika menggunakan firewall, pastikan port yang digunakan oleh Directus terbuka.

Kesimpulan

Anda sekarang telah berhasil menginstal Directus di Ubuntu 24.04 dan menjalankannya menggunakan PM2. Ikuti panduan ini untuk mengkonfigurasi aplikasi Anda lebih lanjut dan menerapkan praktik terbaik untuk operasi yang lebih aman dan efisien. Jika Anda mengalami masalah, jangan ragu untuk melakukan troubleshooting atau mencari solusi di komunitas Directus.

Jika Anda masih memiliki pertanyaan atau membutuhkan bantuan lebih lanjut, silakan konsultasi jasa setup sekarang.