Cara Install n8n dengan Docker: Otomatisasi Workflow di Cloud Server Anda

Setiap kali ada lead baru masuk dari website, tim sales kami harus manual copy paste data ke spreadsheet, lalu input lagi ke CRM, baru kirim notifikasi ke grup Slack. Proses ini kelihatannya sepele, tapi menghabiskan sekitar 5-10 menit per lead. Jika sehari ada 20 lead, itu artinya hampir 3 jam kerja produktif hilang hanya untuk tugas repetitif.

Masalah ini adalah masalah skalabilitas. Semakin bisnis berkembang, semakin banyak waktu yang terbuang. Solusinya adalah otomatisasi. Banyak yang langsung terpikir tool seperti Zapier atau Make. Keduanya bagus, tapi ada satu kendala besar untuk beberapa perusahaan: data harus keluar dari server kita dan diproses di platform mereka. Untuk industri dengan regulasi data ketat atau yang sekadar ingin kontrol penuh, ini jadi pertimbangan serius.

Di sinilah n8n (dibaca: n-eight-n) masuk. n8n adalah platform otomatisasi open-source yang bisa kita install di server sendiri (self hosted). Artinya, semua data dan workflow tetap berada dalam infrastruktur kita. Menggunakan Docker untuk instalasinya membuat proses deployment, maintenance, dan update menjadi jauh lebih sederhana dan terisolasi. Artikel ini adalah panduan teknis, dari praktisi untuk praktisi, tentang cara install n8n dengan Docker di cloud server Anda sendiri.

Mengapa Self Hosted n8n dengan Docker?

Sebelum masuk ke langkah teknis, mari kita samakan persepsi. Kenapa harus repot-repot self host? Kenapa pakai Docker?

Ada tiga alasan utama memilih n8n yang di-hosting sendiri:

1. Kedaulatan Data (Data Sovereignty): Ini alasan paling krusial. Semua kredensial (API keys, password database, token) dan data yang diproses dalam workflow tidak pernah meninggalkan server Anda. Untuk kepatuhan regulasi seperti UU PDP di Indonesia atau GDPR, ini adalah nilai jual yang sangat kuat.
2. Efisiensi Biaya: Model harga SaaS seperti Zapier biasanya berbasis jumlah "task" atau eksekusi. Untuk workflow yang berjalan ribuan kali sebulan, biayanya bisa membengkak. Dengan self hosting, Anda hanya membayar biaya server bulanan yang relatif tetap, tidak peduli berapa banyak workflow yang dieksekusi. Ini penting saat menghitung biaya ingress dan egress cloud jangka panjang.
3. Kustomisasi: Karena sifatnya open source, Anda bisa membuat node kustom sendiri jika butuh integrasi dengan sistem internal yang tidak didukung secara default. Fleksibilitas ini tidak akan Anda dapatkan di platform tertutup.

Lalu, kenapa harus pakai Docker? Docker membungkus aplikasi dan semua dependensinya ke dalam sebuah "container". Ini membuat proses instalasi menjadi sangat bersih dan portabel. Anda tidak perlu pusing menginstall Node.js, database, atau library lain secara manual di server utama. Cukup definisikan semuanya dalam satu file konfigurasi, dan Docker yang akan mengurus sisanya. Ini juga menyederhanakan proses update dan backup.

Persiapan Sebelum Instalasi

Untuk mengikuti panduan ini, Anda memerlukan beberapa hal. Panduan ini bukan untuk pemula absolut, tapi jika Anda pernah mengelola server Linux, prosesnya cukup mudah.

• Cloud Server: Sebuah Virtual Private Server (VPS) atau Cloud Server dengan OS Linux (kami merekomendasikan Ubuntu 22.04). Spesifikasi minimal adalah 2 vCPU, 2GB RAM, dan 30GB SSD. Untuk produksi, 2 vCPU dan 4GB RAM lebih ideal.
• Akses Root/Sudo: Anda harus bisa login ke server melalui SSH dengan user yang memiliki hak akses sudo.
• Docker dan Docker Compose: Keduanya harus sudah terinstall di server Anda. Jika belum, Anda bisa mengikuti panduan resmi dari dokumentasi Docker.
• Domain atau Subdomain: Siapkan sebuah domain (misal: otomatisasi.perusahaananda.com) yang A record-nya sudah diarahkan ke alamat IP publik cloud server Anda. Ini akan kita gunakan untuk mengakses n8n dengan aman via HTTPS.

Langkah-langkah Instalasi n8n dengan Docker Compose

Cara paling andal dan direkomendasikan untuk menjalankan n8n di produksi adalah menggunakan Docker Compose. Ini memungkinkan kita mendefinisikan dan menjalankan beberapa container (seperti n8n itu sendiri dan databasenya) dalam satu file konfigurasi yang rapi.

Langkah 1: Login ke Server dan Buat Direktori

Pertama, hubungkan ke cloud server Anda menggunakan SSH.

ssh user@alamat_ip_server_anda

Setelah berhasil login, buat sebuah direktori khusus untuk menyimpan file konfigurasi n8n agar semuanya tetap terorganisir.

mkdir n8n-data
cd n8n-data

Langkah 2: Buat File docker-compose.yml

Di dalam direktori n8n-data, buat sebuah file bernama docker-compose.yml menggunakan editor teks seperti nano atau vim.

nano docker-compose.yml

Salin dan tempel konfigurasi berikut. Ini adalah konfigurasi siap produksi yang menggunakan database SQLite yang datanya disimpan secara persisten di server Anda.

version: '3.7'

services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      - N8N_HOST=otomatisasi.perusahaananda.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - NODE_ENV=production
      - WEBHOOK_URL=https://otomatisasi.perusahaananda.com/
      - GENERIC_TIMEZONE=Asia/Jakarta
    volumes:
      - ./.data:/home/node/.n8n

Penting: Mari kita bedah beberapa baris konfigurasi di atas:

• image: n8nio/n8n: Menggunakan image Docker n8n resmi yang terbaru.
• restart: always: Memastikan container n8n otomatis berjalan kembali jika server reboot atau terjadi crash.
• ports: - "127.0.0.1:5678:5678": Ini bagian krusial untuk keamanan. Kita hanya mengekspos port 5678 ke localhost (127.0.0.1), bukan ke internet publik. Nantinya, kita akan menggunakan reverse proxy untuk mengaksesnya dengan aman.
• N8N_HOST dan WEBHOOK_URL: Ganti otomatisasi.perusahaananda.com dengan subdomain yang sudah Anda siapkan.
• GENERIC_TIMEZONE: Sesuaikan dengan zona waktu Anda, contohnya Asia/Jakarta. Ini penting agar penjadwalan workflow (cron) berjalan sesuai waktu lokal.
• volumes: - ./.data:/home/node/.n8n: Baris ini memetakan data internal n8n (workflow, kredensial) ke direktori lokal .data di server Anda. Ini krusial agar data Anda persisten dan tidak hilang saat container dihapus atau di update.

Setelah selesai, simpan file tersebut (di nano, tekan Ctrl+X, lalu Y, dan Enter).

Langkah 3: Jalankan Container n8n

Sekarang, kita siap menjalankan n8n. Masih di dalam direktori n8n-data, jalankan perintah berikut:

docker-compose up -d

Perintah ini akan mengunduh image n8n (jika belum ada) dan menjalankan container di background (berkat flag -d). Anda bisa memeriksa apakah container sudah berjalan dengan perintah:

docker-compose ps

Jika semua berjalan lancar, Anda akan melihat statusnya `Up` atau `running`.

Langkah 4: Konfigurasi Reverse Proxy dan SSL

Saat ini, n8n sudah berjalan tapi belum bisa diakses dari internet. Kita perlu sebuah reverse proxy. Tugasnya adalah menerima trafik dari internet (HTTPS port 443) dan meneruskannya ke service n8n yang berjalan di localhost:5678. Selain itu, reverse proxy juga akan mengurus sertifikat SSL/TLS, sehingga koneksi Anda terenkripsi.

Ada banyak pilihan untuk reverse proxy, seperti Nginx, Caddy, atau Traefik. Menurut kami, untuk kemudahan, Nginx Proxy Manager adalah pilihan terbaik karena memiliki antarmuka web yang intuitif. Anda bisa men-deploy-nya sebagai container Docker terpisah. Namun, untuk menjaga artikel ini tetap fokus, kita akan asumsikan Anda sudah memiliki cara untuk setup reverse proxy.

Konfigurasi intinya adalah sebagai berikut:

• Source: https://otomatisasi.perusahaananda.com
• Destination: http://127.0.0.1:5678
• Enable SSL: Gunakan Let's Encrypt untuk sertifikat gratis.
• Enable WebSocket Support: Ini penting agar UI n8n berjalan dengan lancar.

Setelah reverse proxy dikonfigurasi, Anda seharusnya sudah bisa mengakses https://otomatisasi.perusahaananda.com dari browser Anda. Halaman pertama akan meminta Anda untuk membuat akun admin. Selamat, instalasi n8n Anda sudah berhasil!

FAQ: Pertanyaan Umum Seputar Install n8n Docker

Berikut adalah beberapa pertanyaan yang sering kami dapatkan terkait instalasi n8n.

Langkah Selanjutnya

Menginstall n8n adalah langkah pertama. Kekuatan sesungguhnya terletak pada apa yang bisa Anda bangun dengannya. Anda kini memiliki sebuah platform otomatisasi yang kuat, fleksibel, dan sepenuhnya di bawah kendali Anda. Anda tidak lagi dibatasi oleh jumlah task atau khawatir data sensitif terekspos ke pihak ketiga.

Tentu, dengan kontrol penuh datang tanggung jawab penuh. Anda bertanggung jawab untuk menjaga server tetap berjalan, melakukan backup, dan mengamankan sistem. Namun, bagi banyak organisasi yang serius tentang efisiensi dan keamanan data, ini adalah trade off yang sangat sepadan. Mulailah dengan mengotomatisasi satu tugas kecil yang repetitif di tim Anda, dan lihat dampaknya dari sana.