n8n merupakan alat otomasi alur kerja (workflow automation) yang bersifat open-source dan mendukung banyak integrasi aplikasi. Dengan n8n, pengguna dapat mengotomatiskan berbagai proses bisnis seperti sinkronisasi data, notifikasi, pengolahan email, dan lainnya tanpa perlu menulis kode secara kompleks.
Salah satu platform yang mempermudah instalasi dan deployment aplikasi seperti n8n adalah Dokploy. Dokploy adalah platform penyedia layanan deploy otomatis berbasis Docker yang dirancang agar praktis dan mudah digunakan, terutama untuk developer dan DevOps yang ingin fokus pada aplikasi tanpa memikirkan infrastruktur.
Panduan ini akan membahas cara lengkap instalasi aplikasi n8n menggunakan Dokploy mulai dari persiapan hingga menjalankan aplikasi.
1. Persiapan Sebelum Instalasi
Sebelum memulai instalasi, pastikan telah memiliki beberapa hal berikut:
a. Akun Dokploy
Untuk menggunakan layanan Dokploy, buat akun terlebih dahulu di situs resminya https://dokploy.com. Proses pendaftaran mudah dan dapat menggunakan akun GitHub.
b. Repository GitHub (Opsional)
Dokploy bekerja optimal bila aplikasi memiliki repository GitHub, terutama jika ingin memanfaatkan fitur auto-deploy saat ada perubahan. Meski demikian, untuk instalasi aplikasi publik seperti n8n, deployment dapat dilakukan langsung melalui konfigurasi container.
c. Domain (Opsional)
Jika ingin mengakses n8n melalui subdomain khusus, siapkan domain dan akses ke DNS record-nya. Jika tidak memiliki domain, Dokploy tetap dapat menyediakan subdomain default.
2. Mengenal Arsitektur n8n
Sebelum masuk ke proses instalasi, penting untuk memahami arsitektur dasar n8n:
- n8n berbasis Node.js
- Menyimpan data menggunakan SQLite (default) atau PostgreSQL (opsional)
- Dapat dijalankan dalam container Docker
- Memerlukan environment variable untuk pengaturan keamanan dan akses
Dengan pemahaman ini, instalasi dapat dilakukan dengan lebih aman dan efisien.
3. Langkah-Langkah Instalasi n8n di Dokploy
Berikut ini adalah tahapan lengkap instalasi n8n di platform Dokploy:
a. Login ke Dashboard Dokploy
Akses https://app.dokploy.com/, lalu masuk menggunakan akun yang telah dibuat sebelumnya.
b. Buat Project Baru
- Klik tombol “New Project”
- Beri nama proyek misalnya:
n8n-automation - Pilih lokasi server (misalnya: Singapore atau Jakarta, tergantung preferensi)
- Pilih metode deploy: gunakan opsi Docker Image
c. Konfigurasi Docker Image
Masukkan detail konfigurasi sebagai berikut:
- Docker Image:
n8nio/n8n - Port:
5678 - Environment Variables (disarankan):
N8N_BASIC_AUTH_ACTIVE=trueN8N_BASIC_AUTH_USER=adminN8N_BASIC_AUTH_PASSWORD=passwordkuN8N_HOST=n8n.namadomain.com(ubah sesuai domain/subdomain yang digunakan)N8N_PORT=5678WEBHOOK_URL=https://n8n.namadomain.com/(jika menggunakan domain)
Catatan: Gantilah nilai admin dan passwordku sesuai kebutuhan.
Jika tidak memiliki domain, bagian N8N_HOST dan WEBHOOK_URL dapat disesuaikan dengan subdomain default yang diberikan Dokploy.
d. Tambahkan Storage (Opsional)
Untuk penyimpanan data yang berkelanjutan (persistent), tambahkan volume storage:
- Klik Add Volume
- Mount path:
/home/node/.n8n - Ukuran: sesuaikan kebutuhan (misal 1GB untuk testing)
Volume ini akan menyimpan semua workflow dan data internal secara aman meskipun container direstart.
e. Deploy Aplikasi
Klik tombol “Deploy Now” untuk memulai proses instalasi. Tunggu beberapa menit hingga proses selesai dan aplikasi aktif.
4. Mengakses Aplikasi n8n
Setelah aplikasi berhasil dideploy, akses aplikasi dengan menggunakan domain/subdomain yang telah disetting.
Contoh:
- Jika menggunakan domain:
https://n8n.namadomain.com - Jika menggunakan default subdomain:
https://n8n-namaapp.dokploy.app
Akan muncul halaman login, masukkan username dan password yang telah dikonfigurasi sebelumnya di environment variable.
Setelah berhasil login, dashboard n8n akan muncul dan dapat langsung digunakan untuk membuat workflow.
5. Pengaturan Tambahan
a. Menambahkan SSL/TLS Otomatis
Dokploy menyediakan pengamanan HTTPS otomatis melalui sertifikat SSL gratis dari Let’s Encrypt. Hal ini dilakukan secara otomatis saat subdomain aktif, sehingga tidak perlu pengaturan tambahan.
b. Setup Webhook
Jika menggunakan n8n untuk menerima webhook, pastikan URL webhook diakses melalui format berikut:
https://n8n.namadomain.com/webhook/route
Sesuai dengan alur kerja yang dibuat, URL ini dapat digunakan pada aplikasi lain seperti Slack, Notion, Telegram, atau API internal.
c. Backup Data
Lakukan backup secara berkala, terutama jika menyimpan data penting atau memiliki workflow kompleks. Data dapat dicadangkan melalui:
- Export workflow dari dashboard n8n
- Backup direktori
/home/node/.n8ndari volume Dokploy
6. Troubleshooting
Berikut ini beberapa masalah umum yang mungkin muncul:
a. Aplikasi Tidak Bisa Diakses
- Pastikan port
5678terbuka di pengaturan Dokploy - Periksa apakah DNS domain sudah diarahkan dengan benar
- Cek log aplikasi dari dashboard Dokploy untuk melihat error
b. Login Gagal
- Periksa environment variable
N8N_BASIC_AUTH_USERdanN8N_BASIC_AUTH_PASSWORD - Pastikan tidak ada spasi atau karakter aneh yang menyebabkan validasi gagal
c. Webhook Tidak Jalan
- Cek URL webhook yang digunakan
- Pastikan
WEBHOOK_URLenvironment sudah disesuaikan dengan alamat n8n
Keuntungan Menggunakan Dokploy untuk n8n
- Cepat dan Otomatis: Tidak perlu mengatur VPS manual atau membuat Docker Compose sendiri.
- Integrasi GitHub: Bila diinginkan, bisa menyambungkan project GitHub agar auto-deploy.
- TLS/SSL Otomatis: Subdomain aman dengan HTTPS tanpa konfigurasi tambahan.
- Penyimpanan Permanen: Workflow dan data tetap tersimpan meski container direstart.
- UI yang Mudah Dipahami: Cocok untuk pemula hingga profesional.
Kesimpulan
Menginstal n8n di Dokploy adalah solusi yang sangat praktis untuk individu atau tim yang ingin membangun automasi dengan cepat dan efisien tanpa terjebak dalam kerumitan teknis server. Cukup dengan Docker Image, beberapa environment variable, dan konfigurasi sederhana, n8n dapat berjalan lancar di cloud.
