n8n 3.0 Beta Rilis, Ini yang Perlu Disiapkan Pengguna

Sudah siap pindah ke n8n 3.0? Kalau workflow-mu masih memakai node Function, Cron, atau menjalankan n8n lewat npm, jawabannya kemungkinan besar belum.

n8n merilis versi 3.0.0 beta pada 27 Oktober 2026, dan versi stabilnya dijadwalkan awal Desember 2026, per 12 November 2026. Rilis ini lebih banyak berisi perubahan fondasi untuk keandalan, stabilitas, dan keamanan, bukan fitur baru. Fitur baru baru akan datang di lini 3.x setelah versi stabil keluar. Kabar baiknya, kamu masih punya waktu untuk bersiap.

Kenapa upgrade ke 3.0 tidak bisa asal klik?

Ada tiga hal yang membuat upgrade ini berbeda dari pembaruan biasa.

Pertama, upgrade-nya satu arah. n8n menyatakan tidak ada jalan kembali ke 2.x. Kalau ada masalah, satu-satunya cara mundur adalah memulihkan backup.

Kedua, banyak node lama dihapus. Workflow yang sudah dipublikasikan dan masih memakai node yang dihapus tidak akan bisa aktif.

Ketiga, self-hosted wajib Docker. Instalasi lewat npm atau npx n8n tidak lagi didukung, dan n8n 3.0 tidak menerbitkan paket npm yang bisa langsung dijalankan. Instalasi Kubernetes dan Helm tidak terdampak.

Perubahan penting di n8n 3.0

Daftar lengkapnya ada di halaman breaking changes resmi. Ini yang paling sering mengenai pengguna biasa.

Ada juga perubahan lain: rotasi kunci enkripsi aktif secara bawaan, batas dekompresi file diturunkan, fitur Import from URL dihapus dari editor, dan Chat Hub nonaktif secara bawaan. Di queue mode, eksekusi manual kini selalu berjalan di worker, jadi pastikan memori worker cukup. Kalau kamu memakai arsitektur ini, ulasan kapan n8n perlu worker terpisah bisa jadi acuan.

Langkah persiapan sebelum upgrade

Urutan di bawah mengikuti rekomendasi resmi n8n, ditambah beberapa langkah praktis untuk server self-hosted.

1. Naikkan dulu ke versi 2.x terbaru

Migration Report hanya tersedia di versi 2.39 atau lebih baru. Kalau kamu masih di 1.x, naik dulu ke 2.x karena tidak ada jalur langsung dari 1.x ke 3.x. Perlu dicatat, dukungan 1.x berakhir 31 Desember 2026. Panduan update n8n di VPS tanpa kehilangan workflow membahas cara update yang aman.

2. Buka Migration Report

Masuk ke Settings > Migration Report. Alat ini menandai workflow dan pengaturan instance yang terdampak. Banyak masalah bisa diperbaiki otomatis, dan setiap perbaikan disimpan sebagai versi workflow baru sehingga bisa kamu tinjau dulu. Admin juga bisa menetapkan pemilik tiap workflow dan mengekspor ringkasan CSV.

3. Perbaiki atau tandai "won't fix"

Tangani semua yang ditandai. Workflow yang sudah lama tidak aktif atau tidak dipublikasikan bisa ditandai "won't fix" supaya daftar kerjamu tidak menumpuk.

4. Pindah ke Docker bila masih memakai npm

Kalau n8n-mu berjalan dari npm, pindahkan ke Docker selagi masih di 2.x. n8n menyediakan skrip pemasangan satu baris, atau Docker Compose dengan PostgreSQL untuk produksi. Kalau kamu sudah memakai Docker Compose sendiri, file itu tidak perlu diubah.

5. Backup penuh

Selain backup database dan volume Docker, ekspor workflow dan kredensial lewat CLI n8n:

docker exec -it n8n n8n export:workflow --all --output=/home/node/.n8n/workflows.json
docker exec -it n8n n8n export:credentials --all --output=/home/node/.n8n/credentials.json

Ganti n8n pertama dengan nama container-mu. Simpan juga kunci enkripsi (N8N_ENCRYPTION_KEY atau berkas config di folder .n8n), karena tanpa kunci itu kredensial yang diekspor tidak bisa dibuka. Perlakukan file kredensial dengan hati-hati, sesuai prinsip di cara mengamankan kredensial n8n.

6. Uji di staging dulu

Pasang 3.0 beta di instance terpisah yang berisi salinan data, lalu jalankan workflow terpenting. n8n tidak mencantumkan tag image beta khusus di halaman breaking changes, jadi cek tag yang benar di catatan rilis resmi sebelum menarik image. Pengguna n8n Cloud bisa mencoba lewat pilihan "3.0.0 Beta (early access)" saat mengganti versi.

Haruskah upgrade sekarang?

Untuk server produksi, tidak perlu terburu-buru. Versi stabil baru dijadwalkan awal Desember 2026, dan lini 2.x tetap mendapat perbaikan keamanan dan bug kritis selama 12 bulan setelah 3.x stabil. Waktu itu cukup untuk membereskan workflow lama dengan tenang.

Yang sebaiknya dimulai sekarang adalah langkah 1 sampai 3. Makin cepat Migration Report dijalankan, makin jelas berapa banyak workflow yang perlu disentuh.

Checklist singkat sebelum hari H:

• Versi 2.x terbaru sudah terpasang (minimal 2.39).
• Migration Report bersih atau sisanya ditandai "won't fix".
• n8n berjalan di Docker, bukan npm.
• Backup database, workflow, kredensial, dan kunci enkripsi tersimpan di luar server.
• Workflow penting sudah lolos uji di staging.