n8n 3.0: apa yang berubah dan siapa yang perlu bersiap

n8n 3.0 adalah rilis besar yang isinya hampir seluruhnya perapian fondasi. Beta-nya keluar 27 Oktober 2026, versi stabil dijadwalkan awal Desember. Yang terdampak terutama pengguna self-hosted, pemakai node lama seperti Function, Cron, dan Item Lists, serta workflow dengan Slack Trigger. Sebelum upgrade, buka Migration Report di instance kamu.

Tesis artikel ini sederhana: n8n 3.0 bukan rilis untuk dikejar, tetapi untuk dipersiapkan. Fitur baru di n8n sudah keluar hampir tiap minggu sepanjang 2026. Versi 3.0 justru mengumpulkan semua perubahan yang bisa merusak workflow lama ke dalam satu paket. Jadi pertanyaan yang lebih berguna adalah "apa milik saya yang akan berhenti jalan?".

Yang perlu diluruskan dulu

Banyak orang membaca angka "3.0" lalu membayangkan tampilan baru atau fitur AI besar. Pengumuman resminya justru menyebut 3.0 berfokus pada keandalan, stabilitas, dan keamanan. Menurut blog resmi n8n, sejak 2.0 rilis Desember 2025 sudah ada lebih dari 45 rilis, kira-kira satu per minggu. Fitur baru tidak ditahan untuk 3.0.

Alasan nomor versinya naik adalah semantic versioning. Sederhananya, aturan penomoran ini mewajibkan angka depan naik setiap kali ada perubahan yang bisa memaksa pengguna mengubah workflow atau pengaturannya. Daftar perubahan semacam itu dikumpulkan setahun, lalu dilepas sekaligus.

Catatan jujur. Artikel ini ditulis 2 November 2026, saat 3.0 masih berstatus beta atau early access. Daftar perubahan bisa bertambah sebelum versi stabil. Semua fakta diambil dari dokumentasi, blog, dan catatan rilis resmi n8n yang tercantum di bagian Sumber.

Artikel ini untuk kamu yang sudah memakai n8n, baik di n8n Cloud maupun self-hosted, dan ingin tahu apakah perlu repot. Kalau kamu belum pernah memakai n8n sama sekali, cukup ingat satu hal: mulai sekarang, belajarlah dengan node versi terbaru.

Isi n8n 3.0 dalam empat kelompok

Daftar lengkap di halaman breaking changes n8n 3.0 cukup panjang. Breaking change adalah perubahan yang bisa membuat workflow lama gagal atau berperilaku lain. Supaya mudah dicerna, saya kelompokkan menjadi empat.

Keandalan

• Pada mode antrean (queue mode), eksekusi manual kini selalu dijalankan worker, sehingga instance utama tidak ikut terbebani.
• Mode penyimpanan file di memori dihapus. Data biner disimpan di disk atau penyimpanan eksternal seperti S3.
• Batas waktu default Code node turun dari 5 menit menjadi 1 menit. Kode yang berjalan lebih lama akan gagal, kecuali admin menaikkan batasnya.
• Node Cron dan Interval diganti Schedule Trigger yang memakai penjadwal n8n yang lebih tahan gangguan.

Keamanan

• Rotasi kunci enkripsi aktif secara default.
• Kredensial Slack API wajib punya signing secret. Ini kode rahasia dari Slack untuk membuktikan bahwa permintaan memang datang dari Slack. Tanpa itu, workflow dengan Slack Trigger tidak aktif.
• Daftar alamat yang diblokir proteksi SSRF bertambah. SSRF adalah serangan yang memaksa server mengakses alamat internal.
• Community node yang belum terverifikasi tidak lagi bisa dipasang secara default, dan yang sudah terpasang berhenti dimuat.

Self-hosting

n8n self-hosted kini hanya didukung lewat Docker. Pemasangan dengan npm atau perintah npx n8n tidak didukung lagi, dan n8n tidak lagi menerbitkan paket npm yang bisa langsung dijalankan. Pengguna Kubernetes dan Helm tidak terdampak. Untuk pemasangan baru, n8n menyediakan one-line setup berbasis Docker.

Pembersihan

Node lama yang sudah punya pengganti dihapus. Contohnya Function, Function Item, Item Lists, Read PDF, node OpenAI versi lama, dan AI Agent versi 1 beserta mode lamanya. Daftar penggantinya ada di cheat sheet di akhir artikel. Beberapa fitur juga pensiun. Chat Hub dimatikan secara default dan dijadwalkan hilang di 4.0. Menu Import from URL dihapus dari editor, begitu pula tab Ask AI di Code node.

Siapa yang paling terdampak

Tidak semua pengguna perlu panik. Tabel berikut saya susun dari daftar resmi n8n dan saya urutkan dari risiko tertinggi.

Dua baris pertama yang paling mudah terlewat. Selama instance masih di 2.x, workflow dengan node lama tetap berjalan, sehingga masalahnya baru terasa setelah upgrade.

Ada satu kelompok lagi yang sering terlupa: pengguna 1.x. Tidak ada jalur langsung dari 1.x ke 3.x. Kamu harus naik ke 2.x dulu, dan dukungan 1.x berakhir 31 Desember 2026.

Migration Report: buka ini sebelum yang lain

Migration Report adalah halaman di dalam n8n yang memindai instance kamu dan menandai workflow serta pengaturan yang akan bermasalah di 3.0. Letaknya di Settings > Migration Report, tersedia mulai versi 2.39. Menurut dokumentasi migration tool, semua pengguna bisa membukanya. Admin melihat seluruh workflow, sedangkan pengguna lain hanya melihat workflow yang boleh mereka edit.

Setiap temuan diberi salah satu dari lima tingkat dampak:

Untuk sebagian masalah, seperti mengganti Cron dengan Schedule Trigger, tersedia tombol Migrate. Hasilnya disimpan sebagai versi baru workflow. Versi yang sedang dipublikasikan tetap berjalan sampai kamu menerbitkan versi baru itu. Workflow yang tidak lagi dipakai bisa ditandai won't fix. Laporan juga bisa diekspor ke CSV untuk dibagikan ke tim.

Laporan kosong pun belum berarti aman sepenuhnya. Dokumentasi resmi menyebut ada perubahan yang tidak bisa dideteksi alat ini, jadi daftar breaking changes tetap perlu dibaca sekali.

Kapan sebaiknya pindah ke 3.0

Jadwal resminya seperti ini:

Pendapat saya: jangan pasang beta di instance yang menjalankan workflow bisnis. Alasannya ada di FAQ resmi n8n sendiri: upgrade ke 3.x satu arah dan tidak bisa di-rollback. Kalau ada masalah, satu-satunya jalan kembali adalah memulihkan backup.

Saran saya per kondisi:

• Pengguna n8n Cloud. Pemilik instance memilih versi di menu Updates pada Cloud console. Versi 3.0.0 Beta muncul sebagai pilihan early access, dan berpindah ke versi mayor meminta konfirmasi terlebih dahulu. Tunggu versi stabil, tetapi buka Migration Report dari sekarang.
• Self-hosted dengan Docker. Update ke 2.x terbaru, bereskan laporan, lalu coba 3.0 di instance uji dengan salinan data. Pindahkan produksi setelah stabil.
• Self-hosted dengan npm. Ini pekerjaan terbesar. Rencanakan perpindahan ke Docker jauh sebelum Desember, karena kamu mengubah dua hal sekaligus: cara pasang dan versi.
• Masih di 1.x. Prioritaskan naik ke 2.x sebelum 31 Desember 2026. Urusan 3.0 bisa menunggu.

Tidak ada tenggat paksa untuk pindah ke 3.0. Versi 2.x tetap menerima perbaikan keamanan dan bug kritis selama 12 bulan setelah 3.0 stabil. Yang hilang hanya fitur baru, karena semua fitur setelah itu hanya rilis di 3.x.

Ringkasan dan langkah berikutnya

Checklist sebelum upgrade

• Tahu instance saya berjalan di Cloud, Docker, npm, atau Kubernetes
• Sudah di versi 2.39 atau lebih baru, dan Migration Report sudah dibuka
• Semua temuan "Upgrade blocked" dan "Executions will fail" sudah dibereskan
• Kredensial Slack API sudah berisi signing secret
• Workflow yang tidak dipakai ditandai won't fix
• Backup penuh database dan data biner sudah dibuat
• 3.0 sudah dicoba di instance uji, bukan langsung di produksi

Cheat sheet

Catatan rilis lengkap per versi bisa dipantau di release notes n8n. Bagian ini akan saya cek ulang setelah versi stabil keluar.

Kalau kamu sedang menyusun workflow baru, pastikan sejak awal hanya memakai node versi terbaru. n8n Workflow Generator di eduwebmu bisa membantu menyusun kerangka workflow dari deskripsi kebutuhanmu. Periksa hasilnya dengan cheat sheet di atas sebelum dipakai di produksi.