Queue Mode n8n: Skala Workflow Saat Volume Naik
Queue mode adalah cara menjalankan n8n di beberapa proses sekaligus. Satu proses utama menerima trigger dan menaruh eksekusi di antrean Redis, lalu beberapa worker mengambil antrean itu dan menjalankannya bersamaan. Hasilnya, n8n tetap responsif walaupun ribuan eksekusi masuk dalam waktu singkat.
Kalau workflow Anda mulai lambat, editor n8n terasa berat saat jam sibuk, atau webhook dari aplikasi lain kadang timeout, queue mode biasanya jadi langkah berikutnya. Artikel ini membahas tanda-tanda Anda butuh queue mode, cara kerjanya, dan konsekuensi yang perlu Anda siapkan.
Tanda n8n butuh diskalakan
Secara bawaan, n8n berjalan dalam satu proses (mode regular). Proses yang sama menampilkan editor, menerima webhook, menjalankan jadwal, dan mengeksekusi semua workflow. Untuk volume kecil sampai menengah, ini sudah cukup. Masalah mulai muncul saat beban naik.
Beberapa tanda yang sering terlihat:
- Editor terasa lambat saat banyak workflow berjalan, misalnya setiap awal jam saat puluhan jadwal jalan bersamaan.
- Webhook timeout atau gagal diterima saat ada lonjakan, misalnya ketika marketplace mengirim ratusan notifikasi pesanan dalam beberapa menit saat promo.
- Eksekusi menumpuk dan workflow yang seharusnya selesai dalam detik baru selesai beberapa menit kemudian.
- Pemakaian CPU atau memori server sering mentok, dan restart hanya menolong sebentar.
- Satu workflow berat mengganggu workflow lain, misalnya proses import data besar membuat notifikasi approval ikut tertunda.
Sebelum pindah ke queue mode, pastikan dulu masalahnya bukan dari workflow itu sendiri. Workflow yang memproses ribuan item sekaligus tanpa pembagian batch, atau menyimpan data eksekusi lengkap untuk setiap run, bisa membuat server berat walaupun volumenya biasa saja. Memantau durasi dan kegagalan eksekusi, seperti dibahas di artikel monitoring eksekusi n8n, membantu Anda melihat di mana bebannya.
Cara kerja queue mode dengan Redis
Di queue mode, pekerjaan n8n dibagi ke beberapa peran:
- Main instance: menampilkan editor, menangani trigger jadwal dan trigger lain, lalu membuat eksekusi baru. Main instance tidak menjalankan eksekusinya sendiri, hanya meneruskan ID eksekusi ke antrean.
- Redis: berfungsi sebagai message broker, yaitu tempat antrean eksekusi yang menunggu dijalankan.
- Worker: proses n8n terpisah yang mengambil eksekusi dari antrean Redis, menjalankannya, lalu menyimpan hasilnya ke database.
- Webhook processor (opsional): proses khusus yang hanya menerima panggilan webhook dan menaruhnya ke antrean.
- Database: menyimpan workflow, kredensial, dan riwayat eksekusi. Semua proses memakai database yang sama.

Untuk database, dokumentasi n8n tidak menyarankan SQLite di queue mode. Pakai PostgreSQL. Kalau instalasi Anda saat ini masih memakai SQLite bawaan, migrasi database perlu direncanakan lebih dulu. Panduan dasar instalasi dengan Docker dan PostgreSQL ada di artikel cara install n8n dengan Docker.
Secara teknis, queue mode diaktifkan dengan variabel lingkungan EXECUTIONS_MODE=queue, ditambah alamat Redis lewat variabel seperti QUEUE_BULL_REDIS_HOST dan QUEUE_BULL_REDIS_PORT. Satu hal yang wajib: semua main, worker, dan webhook processor harus memakai N8N_ENCRYPTION_KEY yang sama. Tanpa itu, worker tidak bisa membuka kredensial yang disimpan main instance.
Menambah worker
Worker dijalankan dengan perintah n8n worker. Kalau Anda memakai Docker, caranya sama: jalankan image n8n yang sama dengan perintah worker dan variabel lingkungan yang sama dengan main instance.
Setiap worker bisa menjalankan beberapa eksekusi sekaligus. Menurut dokumentasi n8n, nilai bawaannya 10 eksekusi paralel dan bisa diatur dengan flag --concurrency. Dokumentasi juga menyarankan nilai minimal 5, karena nilai yang terlalu kecil dengan banyak worker bisa menghabiskan koneksi ke database.
Beberapa hal praktis saat menambah worker:
- Mulai dari satu atau dua worker. Pantau apakah antrean masih menumpuk sebelum menambah lagi.
- Samakan versi n8n di main, worker, dan webhook processor. Versi yang berbeda bisa membuat eksekusi gagal dengan error yang membingungkan.
- Perhatikan data biner. Dokumentasi n8n menyebutkan queue mode tidak mendukung penyimpanan data biner (file, gambar, PDF) di filesystem lokal. Kalau workflow Anda memproses file, siapkan mode penyimpanan lain seperti S3 atau database.
- Pisahkan server kalau perlu. Worker bisa berjalan di server yang sama dengan main instance, tapi untuk beban tinggi lebih aman di server terpisah supaya satu workflow berat tidak mengganggu editor.
- Aktifkan health check worker (lewat variabel
QUEUE_HEALTH_CHECK_ACTIVE) supaya Anda atau orkestrator container tahu kalau worker mati.
Dengan pola ini, menambah kapasitas cukup dengan menjalankan worker baru. Tidak perlu mengubah workflow sama sekali.
Webhook processor terpisah
Di mode biasa, webhook diterima oleh proses yang sama dengan editor. Kalau ada lonjakan webhook, editor ikut lambat, dan sebaliknya.
Webhook processor dijalankan dengan perintah n8n webhook. Tugasnya hanya menerima permintaan webhook dan menaruh eksekusinya ke antrean. Supaya ini berjalan, Anda butuh load balancer atau reverse proxy yang mengarahkan permintaan ke path /webhook/* ke kumpulan webhook processor, sementara lalu lintas lain (editor, API) tetap ke main instance.
Contohnya, toko online yang menerima notifikasi pembayaran dan pesanan dari beberapa kanal penjualan. Saat promo tanggal kembar, volume webhook bisa naik berlipat dalam hitungan menit. Dengan webhook processor terpisah, lonjakan itu tidak membuat tim admin kesulitan membuka editor untuk memperbaiki workflow lain.
Untuk sebagian besar bisnis kecil, webhook processor terpisah belum diperlukan. Main instance ditambah satu atau dua worker sudah cukup. Webhook processor baru layak dipertimbangkan kalau webhook adalah sumber beban utama.
Biaya dan kompleksitas tambahan
Queue mode menyelesaikan masalah skala, tapi menambah komponen yang harus dirawat. Pertimbangkan hal berikut sebelum memutuskan:
| Aspek | Mode biasa | Queue mode |
|---|---|---|
| Komponen | n8n dan database | n8n main, worker, Redis, PostgreSQL, opsional webhook processor dan load balancer |
| Server | Satu server cukup | Bisa satu server, tapi idealnya beberapa |
| Perawatan | Update satu container | Update semua proses dengan versi yang sama |
| Monitoring | Satu proses | Main, worker, antrean Redis, dan database |
| Data biner | Bisa di filesystem | Perlu S3 atau database |
Biaya server naik karena ada Redis dan proses tambahan. Berapa besarnya tergantung penyedia dan spesifikasi. Gambaran spesifikasi dan biaya VPS di Indonesia bisa Anda lihat di artikel hosting n8n di VPS Indonesia. Harga VPS berubah-ubah, jadi cek lagi sebelum memesan.
Satu catatan soal lisensi: queue mode bisa dipakai di n8n self-host. Fitur yang lebih lanjut, yaitu menjalankan beberapa main instance sekaligus (multi-main) untuk ketersediaan tinggi, membutuhkan lisensi Enterprise per November 2026. Cek halaman resmi n8n untuk ketentuan terbaru.
Kalau Anda ragu apakah perlu queue mode atau cukup merapikan workflow yang ada, lihat bagian layanan kami. Aqilatic juga menawarkan audit proses gratis untuk memetakan workflow mana yang paling berat dan apa langkah paling hemat untuk menanganinya.
Pertanyaan yang sering muncul
Apakah queue mode bisa dipakai di n8n Cloud?
Queue mode adalah pengaturan untuk n8n self-host. Di n8n Cloud, infrastruktur diurus oleh n8n, jadi Anda tidak mengatur worker atau Redis sendiri.
Berapa volume eksekusi yang butuh queue mode?
Tidak ada angka pasti, karena tergantung berat workflow dan spesifikasi server. Patokan yang lebih berguna adalah gejalanya: editor lambat, antrean menumpuk, dan webhook timeout meski workflow sudah dirapikan.
Apakah workflow perlu diubah saat pindah ke queue mode?
Umumnya tidak. Perubahannya ada di infrastruktur dan variabel lingkungan. Yang perlu dicek adalah workflow yang memproses file, karena penyimpanan data biner di filesystem tidak didukung di queue mode.