n8n'i yerel olarak test etmek: npm, Docker ve masaustu uygulamasi karsilastirmasi

n8n'i yerel olarak denemek isteyenler bugun resmi olarak desteklenen iki yol arasindan secim yapabilir: npm uzerinden kurulum veya Docker ile calistirma. Ayri bir masaustu uygulamasi artik yoktur, n8n bu uygulamayi sonlandirmis ve bunun yerine npm uzerinden kurulumu onermektedir. Sabit bir kurulum yapmadan hizli bir test icin npm en uygun secenektir; daha sonra kalici bir isletim icin temel olusturmasi gereken bir yapi icin ise Docker daha saglam bir secimdir. Guncelleme: Temmuz 2026.

npm kurulumu: hizli test, az emek

Yerel olarak n8n calistirmanin en dogrudan yolu npm kurulumudur. Node.js 20.19 ile 24.x arasinda bir surum gereklidir. npx n8n komutuyla n8n, kalici bir kurulum yapilmadan denenebilir ve ardindan http://localhost:5678 adresinden erisilebilir. n8n'i kalici olarak kurmak isterseniz, npm install n8n -g komutuyla global olarak kurun ve ardindan n8n veya n8n start komutuyla baslatin. Guncellemeler npm update -g n8n uzerinden yapilir, surum dusurme belirli bir surumun yeniden kurulmasiyla yapilir, gerekirse veritabani degisikliklerinde n8n db:revert komutu eklenir. Bu secenek varsayilan olarak kimlik bilgilerini, workflow'lari ve gecmis calistirmalari ~/.n8n/database.sqlite altinda bir SQLite veritabaninda saklar, ayni klasorde ayrica sifreleme anahtari ve gunluk dosyalari bulunur. Ilk izlenim edinmek veya tek tek workflow gelistirmek icin bu yeterlidir, ancak birden fazla kullaniciyla kalici isletim icin bu klasor guvenilir bir temel degildir.

Docker: daha temiz bir yapi, uretime daha yakin

Docker yontemi, n8n'i calisma zamani ortamiyla birlikte bir konteynerde kapsuller ve verilerin yeniden baslatmalardan sonra da kalmasi icin adlandirilmis bir volume baglar. n8n'in belgeledigi temel kurulum once bir volume olusturur (docker volume create n8n_data) ve ardindan konteyneri docker run ile baslatir; bu sirada volume /home/node/.n8n dizinine baglanir. Burada da n8n, kimlik bilgileri, calistirmalar ve workflow'lar icin varsayilan olarak SQLite kullanir; yani veriler npm secenegindekiyle ayni dizin biciminde kalir, sadece konteynerlestirilmis ve volume araciligiyla host'tan ayrilmis olur. Daha uretime yonelik senaryolar icin veritabani, ortam degiskenleri (DB_TYPE, DB_POSTGRESDB_*) araciligiyla PostgreSQL'e gecirilebilir. n8n, kendi belgelerinde self-hosting'in teknik bilgi gerektirdigini acikca belirtir; ornegin sunucularin ve konteynerlerin kurulmasi ve yapilandirilmasi, kaynaklarin yonetilmesi ve ortamin guvenliginin saglanmasi konularinda. Bu gorevleri kendiniz ustlenmek istemiyorsaniz, n8n self-hosting'e alternatif olarak kendi bulut secenegine yonlendirir.

Sonlandirilan masaustu uygulamasi

n8n eskiden, Node.js veya Docker olmadan n8n'i yerel olarak baslatmaya olanak taniyan bir masaustu uygulamasi sunuyordu. Bu secenek bu arada sonlandirilmistir, ilgili GitHub deposu arsivlenmistir. n8n, resmi duyurusunda bu adimi, bulut ve self-hosted kullanimin guclu sekilde buyudugunu, buna karsilik masaustu surumunun kiyasla cok az kullanildigini ve bu nedenle artik gelistirilmedigini belirterek gerekcelendirmektedir. Mevcut masaustu kurulumu kullanicilari npm yoluna yonlendirilir, mevcut workflow'lar ve kimlik bilgileri bu sirada aktarilabilir. Kaynak kod herkese acik olarak gorulebilir durumda kalir, bu nedenle topluluk tarafindan bagimsiz bir bakimin en azindan teknik olarak mumkun oldugu soylenebilir, ancak bunun icin artik resmi destek yoktur.

Hangi secenek hangi amac icin

Tek tek workflow'larin kisa bir testi veya arayuzu tanimak icin npx n8n, herhangi bir kurulum adimi olmadan en hizli baslangic noktasidir. Duzenli yerel gelistirme icin global npm kurulumu degerlidir, cunku workflow'lar ve kimlik bilgileri oturumlar arasinda korunur. Ortamin daha uzun sure calismasi, birden fazla servisi entegre etmesi veya daha sonra bir uretim kurulumuna dogru buyumesi gerektiginde, Docker daha mantikli bir baslangic noktasidir; cunku calisma zamani ortami ve veriler net sekilde ayrilmistir ve harici bir veritabanina gecis icin zemin hazirdir. Ekibinizde sunucu ve konteyner konusunda gercekte ne kadar bilgi bulundugundan emin degilseniz, karar vermeden once bu soruyu netlestirmelisiniz, cunku n8n kendi belgelerinde self-hosting'in surekli bakim gerektirdigini acikca belirtmektedir. Bu degerlendirmeyi, yerel bir test kurulumunun mu yoksa dogrudan uretimde calisan bir sunucunun mu daha mantikli oldugunu kendileri karar vermek isteyen musteriler icin n8n ile otomasyon hizmetimiz kapsaminda biz ustleniyoruz.

n8n'i yerelde test etme hakkinda sik sorulan sorular

n8n masaustu uygulamasi hala var mi?

Hayir. n8n masaustu uygulamasini sonlandirmistir, ilgili depo arsivlenmistir. Yerine n8n, npm uzerinden kurulumu onermektedir.

npm kurulumu icin hangi Node.js surumune ihtiyacim var?

n8n, kendi belgelerine gore 20.19 ile 24.x arasinda bir Node.js surumu gerektirmektedir.

n8n, yerel bir kurulumda workflow'larimi nerede saklar?

Varsayilan olarak hem npm kurulumunda hem de Docker'da ~/.n8n/database.sqlite altinda bir SQLite veritabaninda, ancak Docker'da bu, baglanan volume icinde yer alir.

Yerel bir npm veya Docker kurulumuyla dogrudan uretimde calisabilir miyim?

Teknik olarak evet, ancak n8n, self-hosting'in sunucu ve konteyner isletimi, kaynak yonetimi ve guvenlik alanlarinda bilgi gerektirdigini acikca belirtmektedir. Bu nedenle kalici isletim icin genellikle PostgreSQL gibi harici bir veritabanina gecis yapmak ve self-hosting lehine veya aleyhine bilincli bir karar vermek onerilir.