n8n merilis versi 3.0.0 beta pada 27 Oktober 2026, dan rilis stabilnya dijadwalkan awal Desember. Versi ini menghapus node lama seperti Cron, Function, dan Item Lists, mewajibkan Docker untuk self-hosted, dan memperketat pengaturan keamanan bawaan. Upgrade bersifat satu arah, sehingga periksa Migration Report sebelum memperbarui instance kamu.
Bagi kamu yang menjalankan n8n untuk otomasi bisnis, rilis ini bukan pembaruan rutin. Workflow yang berjalan normal hari ini dapat berhenti setelah upgrade bila masih menggunakan node lama atau berjalan dari instalasi npm. Artikel ini merangkum pengumuman resmi n8n dan daftar breaking changes di dokumentasinya.
Apa saja yang berubah di n8n 3.0?
Menurut blog resmi n8n, versi 3.0 berfokus pada keandalan, stabilitas, dan keamanan, bukan fitur baru. Perubahannya terbagi ke beberapa kelompok:
- Deployment: self-hosted n8n kini berjalan di Docker. Instalasi melalui
npmataunpx n8ntidak lagi didukung. - Node lama dihapus: Cron, Interval, Function, Function Item, Item Lists, node OpenAI versi lama, dan mode lama AI Agent.
- Batas eksekusi: waktu maksimal Code node turun dari 5 menit menjadi 1 menit.
- Keamanan: beberapa pengaturan bawaan dibuat lebih aman, termasuk community package yang belum terverifikasi kini nonaktif.
- Fitur yang dipensiunkan: Chat Hub nonaktif secara bawaan, Import from URL dihapus dari editor, dan tab Ask AI di Code node ditiadakan.
Semua perubahan ini berlaku untuk edisi Community, Cloud, dan Enterprise/Business.
Mengapa instalasi n8n melalui npm berhenti didukung?
Dokumentasi n8n menyatakan versi 3.0 tidak lagi menerbitkan paket n8n yang dapat dijalankan di npm. Bila server kamu menjalankan n8n dengan perintah npx n8n atau hasil npm install, kamu perlu pindah ke Docker sebelum upgrade. n8n menyediakan skrip penyiapan satu baris dan panduan Docker Compose untuk proses ini.
Kamu yang sudah menjalankan n8n melalui Docker Compose sendiri tidak perlu berpindah cara. Pengguna Kubernetes dan Helm juga tidak terdampak. Bagi developer node kustom, perintah n8n-node dev kini memerlukan Docker atau Podman.
Node apa saja yang dihapus dan apa penggantinya?
Ini bagian yang paling berisiko bagi workflow lama. Berikut pemetaan pengganti dari dokumentasi resmi:
- Cron dan Interval: diganti Schedule Trigger.
- Function: diganti Code node dengan mode "Run Once for All Items".
- Function Item: diganti Code node dengan mode "Run Once for Each Item".
- Item Lists: diganti node sesuai operasinya, yaitu Split Out, Aggregate, Sort, Limit, Remove Duplicates, atau Summarize.
- OpenAI (versi lama) dan OpenAI Assistant: diganti node OpenAI terbaru, dengan resource Assistant untuk kebutuhan asisten.
- OpenAI Model: diganti OpenAI Chat Model.
- AI Agent v1: dihapus beserta mode lamanya. Versi terbaru menggunakan Tools Agent.
Daftar penghapusan juga mencakup HTML Extract, Read PDF, Read/Write Binary File, iCalendar, Edit Image versi 1 dan 1.1, serta beberapa node vector store. Perhatikan bahwa LangChain Code, Motorhead, Zep, dan SerpApi tidak memiliki pengganti langsung, sehingga workflow yang bergantung pada node tersebut perlu dirancang ulang.
Mengapa workflow dengan Code node dapat gagal setelah upgrade?
Batas waktu bawaan task runner untuk Code node turun dari 300 detik menjadi 60 detik. Code node yang memproses data besar, misalnya mengolah ribuan baris dari spreadsheet, dapat gagal karena melewati batas baru tersebut.
Solusinya sederhana. Tetapkan variabel N8N_RUNNERS_TASK_TIMEOUT secara eksplisit dengan nilai yang sesuai kebutuhan workflow kamu. Selain itu, mode penyimpanan binary data di memori dihapus dan instance otomatis beralih ke mode filesystem. Folder ~/.n8n/binaryData juga berganti nama menjadi ~/.n8n/storage.
Pengaturan keamanan apa yang kini lebih ketat?
n8n mengubah beberapa pengaturan bawaan agar lebih aman sejak awal:
- Community package: variabel
N8N_UNVERIFIED_PACKAGES_ENABLEDkini bernilaifalse. Community node yang belum terverifikasi tidak dapat dipasang dan yang sudah terpasang berhenti dimuat. Tetapkan nilainyatruebila kamu masih membutuhkannya, atau beralih ke node yang sudah terverifikasi. - Kunci enkripsi: rotasi encryption key selalu aktif.
- Slack: kredensial Slack API wajib memiliki signing secret.
- SSRF: daftar alamat yang diblokir bertambah empat rentang saat perlindungan SSRF aktif.
- Dekompresi: batas ukuran turun dari 2 GiB menjadi 256 MiB, dan jumlah entri zip dari 5.000 menjadi 1.000.
Bagi bisnis yang menjalankan n8n untuk data pelanggan, perubahan ini layak disambut. Namun, workflow yang bergantung pada community node lama perlu dicek lebih dulu.
Bagaimana cara memeriksa workflow sebelum upgrade?
Gunakan Migration Report di menu Settings > Migration Report, yang tersedia sejak versi 2.39. Fitur ini mendaftar workflow dan pengaturan instance yang terdampak, memperbaiki sebagian masalah secara otomatis sebagai versi workflow baru untuk kamu tinjau, dan menyediakan ekspor CSV.
Urutan upgrade yang direkomendasikan n8n:
- Perbarui instance ke versi 2.x terbaru, lalu buka Migration Report.
- Perbaiki atau tandai "won't fix" setiap temuan.
- Buat backup lengkap.
- Upgrade instance uji atau staging lebih dulu, baru kemudian production.
Pengguna n8n Cloud memilih opsi "3.0.0 Beta (early access)" saat mengganti versi. Kredensial dan riwayat eksekusi ikut terbawa, dan downtime hanya berupa restart singkat.
Kapan sebaiknya kamu upgrade ke n8n 3.0?
Untuk instance production, tunggu rilis stabil di awal Desember. Versi 3.0.0 saat ini masih beta, dan n8n menegaskan upgrade tidak dapat dibatalkan ke 2.x. Manfaatkan waktu sebelum rilis stabil untuk menjalankan Migration Report dan mengganti node lama.
Perhatikan juga jadwal dukungan. Versi 2.x tetap menerima perbaikan keamanan dan bug kritis selama 12 bulan setelah 3.0 stabil. Dukungan versi 1.x berakhir 31 Desember 2026, dan tidak ada jalur langsung dari 1.x ke 3.x. Pengguna 1.x perlu naik ke 2.x terlebih dahulu.
Tim Aijen Teknologi Indonesia menyarankan inventarisasi sederhana sebelum upgrade: catat workflow yang masih menggunakan Cron, Function, Item Lists, atau node OpenAI lama, karena node tersebut umum ditemukan di workflow yang disusun sebelum versi 2.x.
Pertanyaan yang Sering Diajukan
Apakah workflow lama akan langsung rusak setelah upgrade ke n8n 3.0? Hanya workflow yang menggunakan node atau pengaturan yang dihapus. Migration Report menunjukkan workflow mana yang terdampak, sehingga kamu dapat memperbaikinya sebelum upgrade.
Apakah saya dapat kembali ke n8n 2.x setelah upgrade? Tidak. n8n menyatakan upgrade ke 3.0 bersifat satu arah. Karena itu, buat backup lengkap dan uji di instance staging terlebih dahulu.
Saya menjalankan n8n dengan npx di VPS. Apa yang harus dilakukan? Pindahkan instalasi ke Docker sebelum upgrade, karena n8n 3.0 tidak lagi mendukung npm dan npx. Gunakan skrip penyiapan satu baris atau Docker Compose dari dokumentasi resmi.
Kapan n8n 3.0 versi stabil dirilis? n8n menjadwalkan rilis stabil pada awal Desember 2026. Versi yang tersedia saat ini adalah 3.0.0 beta yang dirilis 27 Oktober 2026.
Sumber
- n8n Blog, Ophir Prusak, "Introducing n8n 3.0" (27 Oktober 2026): https://blog.n8n.io/introducing-n8n-v3/ (dicek 16 November 2026)
- Dokumentasi n8n, "v3.0 Breaking changes": https://docs.n8n.io/changelog/v30-breaking-changes (dicek 16 November 2026)