VPS پر n8n بار بار آف لائن کیوں ہو جاتا ہے؟
n8n کا offline دکھائی دینا 4 مختلف خرابیوں کی علامت ہو سکتا ہے: websocket banner، restart loop، out of memory kill یا dead schedule کو الگ کرنے کا طریقہ جانیں۔
n8n کے بار بار آف لائن ہونے کی وجہ: چار خرابیاں، ایک علامت
"n8n keeps going offline" ایک جملہ ہے جو چار مختلف خرابیوں کو بیان کرتا ہے، اور ہر خرابی کے لیے الگ حل درکار ہوتا ہے۔ ایڈیٹر میں connection lost کا banner دکھائی دیتا ہے، جبکہ container معمول کے مطابق چل رہا ہوتا ہے۔ container خود restart ہو جاتا ہے۔ kernel زیادہ memory استعمال کرنے پر Node.js process کو ختم کر دیتا ہے۔ یا process میں کوئی خرابی نہیں ہوتی، مگر فعال workflow کبھی execute ہی نہیں ہوتا۔ غلط setting تبدیل کرنے سے آپ پورا weekend ایسے مسئلے پر صرف کر سکتے ہیں جو حقیقت میں موجود ہی نہیں تھا۔
اس لیے configuration تبدیل کرنے سے پہلے معلوم کریں کہ آپ کو کون سی خرابی درپیش ہے۔ n8n ایک main Node.js process چلاتا ہے، جو عموماً Docker container کے اندر reverse proxy کے پیچھے ہوتا ہے۔ یہ reverse proxy TLS (transport layer security) termination کرتا ہے۔ Code nodes بھی task runner processes استعمال کرتے ہیں: internal mode میں child process شروع ہوتا ہے، جبکہ external mode میں یہ الگ چلتے ہیں، عموماً sidecar container میں۔ ان میں سے ہر layer اپنے الگ طریقے سے ناکام ہوتی ہے، اور browser connection failures کو ایک ہی message کے ساتھ رپورٹ کرتا ہے۔
اس ترتیب سے تشخیص کریں
VPS (virtual private server) پر یہ commands چلائیں اور وہ values پڑھیں جو آپ کی اپنی machine دکھاتی ہے۔ ان کا موازنہ کسی forum thread میں موجود numbers سے نہ کریں۔ یہاں اہم values آپ کے اپنے server کی ہیں، کسی اور کے server کی نہیں۔
docker ps -a --filter name=n8n
docker logs --tail 200 --timestamps n8n
docker inspect n8n | grep -iE 'Status|Running|RestartCount|OOMKilled|ExitCode'
docker stats --no-streamdocker ps -a کی STATUS column بتاتی ہے کہ container اپنی موجودہ state میں کتنے عرصے سے ہے۔ اس کا موازنہ اس وقت سے کریں جب مسئلہ شروع ہوا تھا۔ اگر banner ظاہر ہونے سے کافی پہلے سے container چل رہا ہو تو اس سے معلوم ہوتا ہے کہ اس وقت container restart نہیں ہوا تھا، لیکن اس سے یہ ثابت نہیں ہوتا کہ n8n دستیاب رہی۔ آگے بڑھنے سے پہلے reachability کے لیے /healthz اور connected، migrated database کے لیے /healthz/readiness چیک کریں۔ اس کے بعد اگلے section میں بیان کردہ websocket path کی جانچ کریں۔
RestartCount بتاتا ہے کہ Docker نے اس container کو کتنی بار restart کیا ہے۔ یہ number لکھ لیں، ایک minute انتظار کریں، پھر اسے دوبارہ پڑھیں۔ اگر آپ کے دیکھتے ہوئے number بڑھتا رہے تو یہ restart loop ہے، اور ہر restart سے فوراً پہلے کی log lines اس کی وجہ بتاتی ہیں۔
OOMKilled ایک true یا false flag ہے۔ True کا مطلب ہے کہ Docker نے container میں out of memory kill record کیا ہے۔ Logs اور kernel messages کے ساتھ اسے پڑھیں تاکہ معلوم ہو سکے کہ کون سا process ختم ہوا اور memory pressure container کی limit سے پیدا ہوا یا پوری machine سے۔
ExitCode وہ exit code دکھاتا ہے جس کے ساتھ container آخری بار بند ہوا تھا۔ آپ کو ہر code کا مطلب یاد رکھنے کی ضرورت نہیں۔ اپنا code پڑھیں، پھر اسی timestamp سے docker logs کا آخری حصہ پڑھیں۔ Log tail اور out of memory flag مل کر بتاتے ہیں کہ کیا ہوا، جبکہ ان میں سے کوئی ایک اکیلا گمراہ کر سکتا ہے۔
docker stats موجودہ memory use کو نافذ limit کے ساتھ دکھاتا ہے۔ اسے دوسری terminal میں چلتا رہنے دیں، وہ workflow چلائیں جس سے مسئلہ پیدا ہوتا ہے، اور failure کے دوران دیکھیں کہ number کیسے بدلتا ہے۔
کنکشن ختم ہونے کا بینر عموماً آپ کے reverse proxy کی وجہ سے ہوتا ہے
n8n editor backend کے ساتھ ایک طویل مدتی push connection کھلا رکھتا ہے تاکہ execution progress کو canvas پر stream کیا جا سکے۔ پہلے سے یہ connection WebSocket ہوتا ہے، جسے N8N_PUSH_BACKEND منتخب کرتا ہے، اور اس کی default value websocket ہے۔ WebSocket کا آغاز ایک عام HTTP request سے ہوتا ہے، جس میں Connection: Upgrade اور Upgrade: websocket headers شامل ہوتے ہیں۔ سرور 101 Switching Protocols کے ساتھ جواب دیتا ہے، اور اس کے بعد دونوں فریق ایک ہی TCP socket کو دونوں سمتوں میں استعمال کرتے ہیں۔
دو proxy مسائل اس connection کو توڑ دیتے ہیں۔ Proxy upstream کے لیے HTTP/1.0 استعمال کرتا ہے یا upgrade headers ہٹا دیتا ہے، اس لیے upgrade مکمل نہیں ہوتا اور editor مسلسل reconnect کرتا رہتا ہے۔ یا upgrade کامیاب ہو جاتا ہے، لیکن proxy بعد میں socket بند کر دیتا ہے کیونکہ یہ کچھ دیر سے خاموش ہوتا ہے؛ messages کے بغیر WebSocket بالکل idle connection جیسا دکھائی دیتا ہے۔ n8n خود بھی authentication یا request-validation کی ناکامیوں کی وجہ سے push connections مسترد کر سکتا ہے، جن میں pushRef کا missing ہونا یا invalid origin شامل ہے۔ یہ بینر صرف یہ بتاتا ہے کہ browser کا channel ختم ہو گیا ہے؛ اس سے یہ ثابت نہیں ہوتا کہ container درست حالت میں ہے۔
کسی بھی چیز میں ترمیم کرنے سے پہلے browser میں اس کی تصدیق کریں۔ developer tools کھولیں، Network tab پر جائیں، WS پر filter لگائیں، اور editor کو reload کریں۔ Push request کو 101 Switching Protocols تک پہنچنا چاہیے اور کھلا رہنا چاہیے۔ اگر push request ordinary status code واپس کرے یا ہر چند سیکنڈ بعد دوبارہ ظاہر ہو، تو اس کے response اور n8n logs دیکھیں تاکہ proxy، authentication یا origin errors معلوم کیے جا سکیں۔
وہ nginx ترتیبات جو editor کا کنکشن برقرار رکھتی ہیں
nginx اس وقت تک upgrade آگے نہیں بھیجتا جب تک آپ اسے ایسا کرنے کا نہ کہیں۔ Connection اور Upgrade hop-by-hop headers ہیں، جنہیں nginx آگے بھیجتے وقت ہٹا دیتا ہے، اس لیے آپ کو دونوں دوبارہ شامل کرنے ہوں گے۔ upstream protocol آپ کے nginx release پر منحصر ہے: 1.29.7 (March 2026) سے proxy_pass backend کے ساتھ بطورِ default HTTP/1.1 استعمال کرتا ہے، جبکہ اس سے پہلے HTTP/1.0 استعمال ہوتا تھا، جو upgrade منتقل نہیں کر سکتا۔ اپنے استعمال ہونے والے ورژن کو دیکھنے کے لیے nginx -v چلائیں۔ ذیل کی configuration میں proxy_http_version 1.1 کو واضح رکھا گیا ہے تاکہ یہ دونوں صورتوں میں کام کرے؛ 1.29.7 یا بعد کے ورژنز میں یہ سطر صرف default کو دوبارہ بیان کرتی ہے۔ map block کو http context میں رکھیں، server کے اندر نہیں۔ اگر نیچے دیا گیا server block آپ کے لیے نیا ہے تو nginx server block کی سطر بہ سطر وضاحت میں ہر directive کا کام بیان کیا گیا ہے۔
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}server {
listen 443 ssl;
http2 on;
server_name n8n.example.com;
location / {
proxy_pass http://127.0.0.1:5678;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
proxy_buffering off;
}
}proxy_read_timeout کی default قدر 60 seconds ہے اور یہ upgraded WebSocket پر بھی لاگو ہوتی ہے؛ اس کا حساب backend سے ہونے والی reads کے درمیان وقت کے مطابق کیا جاتا ہے۔ n8n ہر 60 seconds بعد push pings بھیجتا ہے، اس لیے خاموش workflow instance کا مطلب یہ نہیں کہ socket پر کوئی traffic نہیں ہے۔ timeout بڑھانے سے ان pings کو default timeout کے ساتھ مقابلہ کیے بغیر پہنچنے کی گنجائش ملتی ہے؛ periodic ping frames بھی timeout کو دوبارہ شروع کر دیتے ہیں۔
sudo nginx -t && sudo systemctl reload nginx
sudo nginx -T | grep -iE 'proxy_http_version|upgrade|proxy_read_timeout'nginx -T شامل کی گئی files سمیت configuration files کو test اور print کرتا ہے، نہ کہ اس configuration کو inspect کرتا ہے جو چلتے ہوئے process نے پہلے ہی load کی ہے۔ یہ بھی تصدیق کریں کہ reload کامیاب ہوا ہے۔ اگر configuration کسی ایسی file میں ہو جسے include کی کوئی line شامل نہیں کرتی، تو درست fix کے باوجود کچھ تبدیل ہوتا دکھائی نہیں دے گا۔
اب n8n کو بتائیں کہ یہ proxy کے پیچھے ہے، کیونکہ یہ ان values سے URLs بناتا ہے۔
environment:
- N8N_HOST=n8n.example.com
- N8N_PROTOCOL=https
- N8N_PORT=5678
- N8N_PROXY_HOPS=1
- N8N_WEBHOOK_URL=https://n8n.example.com/N8N_PROXY_HOPS کی default قدر 0 ہے، جس کا مطلب ہے کہ n8n connecting address کو client address سمجھتا ہے اور X-Forwarded-For کو نظر انداز کرتا ہے۔ اسے container کے سامنے موجود proxies کی تعداد پر set کریں۔ October 2026 تک N8N_WEBHOOK_URL موجودہ نام ہے، جبکہ پرانا WEBHOOK_URL startup پر deprecation warning دکھاتے ہوئے اب بھی کام کرتا ہے۔
Traefik WebSocket کو خودکار طور پر forward کرتا ہے
Traefik کسی middleware یا اضافی labels کے بغیر WebSocket upgrade کو forward کرتا ہے۔ اس کے پہلے سے مقررہ HTTP timeouts، upgraded WebSocket کے لیے timeout مقرر نہیں کرتے۔ درج ذیل settings entryPoint پر لاگو ہوتی ہیں: اکتوبر 2026 تک Traefik v3 میں، idleTimeout idle HTTP keep-alive connections کے لیے 180 seconds پر مقرر ہے، جبکہ readTimeout request، بشمول اس کے body، کو پڑھنے کے لیے 60 seconds پر مقرر ہے۔ Response write timeout protocol upgrades کو واضح طور پر خارج کرتا ہے۔ یہ مثال HTTP timeouts تبدیل کرتی ہے؛ یہ WebSocket banner کے لیے آزمودہ حل نہیں ہے۔
entryPoints:
websecure:
address: ":443"
transport:
respondingTimeouts:
readTimeout: 0
idleTimeout: 3600sCaddy reverse_proxy میں upgrade خودکار طور پر handle کرتا ہے اور اس کے لیے کسی directive کی ضرورت نہیں ہوتی۔ اگر آپ proxy میں بالکل تبدیلی نہیں کر سکتے، کیونکہ اس کا انتظام کوئی اور کرتا ہے، تو push channel کو N8N_PUSH_BACKEND=sse کے ذریعے تبدیل کریں۔ SSE (server-sent events) ایک معمول کا HTTP response ہے جو کھلا رہتا ہے، اس لیے یہ ایسے proxy کے ساتھ بھی کام کرتا رہتا ہے جو upgrades مسترد کرتا ہے، اگرچہ بہت کم idle timeout اسے بھی منقطع کر دے گا۔ Proxy کا انتخاب خود ایک الگ فیصلہ ہے، اور nginx، Caddy اور Traefik کا تقابلی جائزہ میں بتایا گیا ہے کہ ہر proxy کو چلانے میں آپ کو کیا لاگت اٹھانا پڑتی ہے۔
جب container واقعی طور پر restart ہو رہا ہو
اگر RestartCount بڑھ رہا ہے تو container ناکام ہو رہا ہے اور Docker اسے دوبارہ چلا رہا ہے۔ ہر restart کے وقت کو log timestamps کے ساتھ ملائیں اور فوراً اس سے پہلے آنے والے پیغام کو پڑھیں۔ عام وجوہات میں startup روکنے والی configuration error، ایسا database جس تک n8n رسائی حاصل نہیں کر سکتا، چلنے کے بعد crash، اور memory kill شامل ہیں۔
سب سے پہلے volume کی جانچ کریں، کیونکہ permissions کا مسئلہ اکثر خاموشی سے پیدا ہوتا ہے۔ official image غیر مراعات یافتہ user node کے طور پر چلتی ہے اور اپنا data /home/node/.n8n میں رکھتی ہے۔ اگر bind mount اس user کے لیے writable نہ ہو تو process اپنا data لکھنے کی کوشش کے وقت ناکام ہو جاتا ہے، اور restart policy اس failure کو loop میں تبدیل کر سکتی ہے۔
docker compose config
docker run --rm -it --entrypoint sh docker.n8n.io/n8nio/n8n -c 'id'
docker exec n8n ls -ld /home/node/.n8nنیا named volume اس وقت image directory کی ownership حاصل کرتا ہے جب Docker اسے populate کرتا ہے؛ موجودہ volume کی permissions پھر بھی check کرنا ضروری ہے۔ اگر آپ کو bind mount درکار ہو تو host directory کی ownership اس numeric user id پر مقرر کریں جو id command نے دکھائی ہے، جس کے لیے chown استعمال کریں۔ host اور container کے درمیان ownership mapping کو ایک بار سمجھ لینا مفید ہے، اور PUID اور PGID کی وضاحت میں بتایا گیا ہے کہ یہ images فیصلہ کیسے کرتی ہیں کہ files کون لکھے گا۔
وہ out of memory kill جو crash جیسا دکھائی دیتا ہے
n8n process کے اوپر memory کی دو الگ ceilings ہوتی ہیں، اور ان میں خرابی بھی مختلف انداز سے ظاہر ہوتی ہے۔ Container control group limit kernel نافذ کرتا ہے: اگر usage اس limit تک پہنچ جائے اور اسے کم نہ کیا جا سکے تو kernel OOM killer چلا دیتا ہے۔ Usage عارضی طور پر اس limit سے تجاوز کر سکتی ہے۔ OOM kill متاثرہ process کو آخری log entry لکھنے کا موقع نہیں دیتا، اور Docker اسے OOMKilled میں record کرتا ہے۔ V8 heap limit Node.js کے اندر نافذ ہوتی ہے: اسے ختم کرنے پر fatal heap error پیدا ہوتا ہے اور process kernel OOM kill کے بغیر exit ہو جاتا ہے۔ Browser سے دونوں صورتیں ایک جیسی دکھائی دیتی ہیں۔ ان میں فرق کرنے کے لیے logs کے ساتھ docker inspect پڑھیں۔
Node heap ceiling کو container limit سے کم رکھیں تاکہ native allocations، buffers، دیگر heap regions اور container میں موجود دیگر processes کے لیے جگہ باقی رہے۔ زیادہ heap ceiling سے یہ خطرہ بڑھ جاتا ہے کہ V8 اپنی limit تک پہنچنے سے پہلے kernel OOM kill کر دے، لیکن اس کی ضمانت نہیں ہوتی: memory reclaim یا swap ہو سکتی ہے، اور workload ممکن ہے کسی بھی ceiling کو ختم نہ کرے۔ کم heap ceiling بھی اس بات کی ضمانت نہیں دیتی کہ container OOM kill سے پہلے heap error آئے گا۔
services:
n8n:
image: docker.n8n.io/n8nio/n8n
restart: unless-stopped
environment:
- NODE_OPTIONS=--max-old-space-size=<MiB, below the container limit>
deploy:
resources:
limits:
memory: <your container limit>Heap placeholder کو MiB میں numeric value سے replace کریں، اور --max-old-space-size=SIZE کی شکل استعمال کریں۔ دونوں numbers اپنی VPS میں موجود اصل memory کے مطابق منتخب کریں، اور database، proxy اور operating system کے لیے جگہ باقی رکھیں۔ docker stats --no-stream موجودہ use کو نافذ limit کے ساتھ دکھاتا ہے، اس لیے آپ تصدیق کر سکتے ہیں کہ جو limit لکھی گئی ہے وہی limit Docker نے apply کی ہے۔ Compose memory limits کیسے apply ہوتی ہیں میں بتایا گیا ہے کہ کئی limits set ہونے پر کون سی key مؤثر ہوتی ہے۔
Execution data وہ ڈیٹا ہے جو وقت کے ساتھ بڑھتا رہتا ہے
ایک execution کے دوران ہر node کا output محفوظ رہتا ہے، اور run جاری رہنے پر n8n اس ڈیٹا کو اپنی execution saving settings کے مطابق store کرتا ہے۔ اس کے دو نتائج ہیں۔ ڈیٹا کی مقدار اور ہر node کا کام peak memory پر اثر انداز ہوتے ہیں، اس لیے ایک ہی workflow کا ایک وقت میں دس ہزار rows handle کرنا، اسی workflow کے ایک وقت میں دو سو rows handle کرنے سے مختلف پروگرام ہے۔ اس کے علاوہ محفوظ شدہ copy اس وقت تک بڑھتی رہتی ہے جب تک کوئی اسے delete نہ کر دے۔
Pruning دوسرے مسئلے کو حل کرتی ہے۔ اکتوبر 2026 تک default settings میں pruning enabled ہے، EXECUTIONS_DATA_MAX_AGE کی قدر 336 hours (14 days) اور EXECUTIONS_DATA_PRUNE_MAX_COUNT کی قدر 10000 ہے۔ یہ ایک چھوٹے VPS کے لیے، جو SQLite چلا رہا ہو، نسبتاً فراخ settings ہیں۔ اس صورت میں ایک ہی file میں سب کچھ محفوظ ہوتا ہے، اور editor serve کرنے والے اسی process کو اسے read اور write کرنا پڑتا ہے۔
environment:
- EXECUTIONS_DATA_PRUNE=true
- EXECUTIONS_DATA_MAX_AGE=72
- EXECUTIONS_DATA_PRUNE_MAX_COUNT=1000
- EXECUTIONS_DATA_SAVE_ON_SUCCESS=none
- EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=falseEXECUTIONS_DATA_SAVE_ON_SUCCESS=none aggressive setting ہے۔ یہ successful executions کو save کرنا disabled کر دیتی ہے؛ failed executions محفوظ رہتی ہیں اگر EXECUTIONS_DATA_SAVE_ON_ERROR اپنی default قدر all پر برقرار رہے، اور individual workflow settings ان انتخاب کو override کر سکتی ہیں۔ یہ فیصلہ جان بوجھ کر کریں، کیونکہ اگر کسی workflow نے error ظاہر کیے بغیر غلط output پیدا کیا تو پھر آپ کے پاس اس کی جانچ کے لیے کچھ نہیں بچے گا۔ Pruning پہلے rows کو deleted mark کرتی ہے اور بعد کے pass میں انہیں remove کرتی ہے۔ SQLite خالی ہونے والے pages کو واپس کرنے کے بجائے دوبارہ استعمال کرتا ہے، اس لیے setting تبدیل کرتے ہی disk پر موجود file چھوٹی نہیں ہوتی۔
Stored total کے بجائے peak کم کرنے کے لیے ہر run میں کم data منتقل کریں۔ بڑے jobs کو ایسے sub-workflows میں تقسیم کریں جو parent کو چھوٹے results واپس کریں، Loop Over Items node کے ذریعے batch بنائیں، اور پورے datasets کو Code node سے باہر رکھیں۔
بائنری فائلیں میموری کے ذریعے منتقل نہیں ہونی چاہییں
N8N_DEFAULT_BINARY_DATA_MODE کی default قدر default ہے، جس کے باعث بائنری ڈیٹا چلنے والے execution کی میموری میں رکھا جاتا ہے۔ Workflow کے ذریعے download کی جانے والی فائلیں بھی میموری کے استعمال میں شامل ہوتی ہیں۔ ایک workflow چند بڑی attachments حاصل کرے تو process ایسی حد سے تجاوز کر سکتا ہے جس تک عام JSON کام کبھی نہیں پہنچتا۔ اسی لیے crash وقت کے ساتھ نہیں بلکہ ایک مخصوص workflow کے بعد ہوتا ہے۔
environment:
- N8N_DEFAULT_BINARY_DATA_MODE=filesystemfilesystem کے ساتھ بائنری ڈیٹا N8N_BINARY_DATA_STORAGE_PATH کے تحت لکھا جاتا ہے۔ یہ default طور پر n8n user folder کے اندر ہوتا ہے، اس لیے ڈیٹا اسی volume پر محفوظ ہوتا ہے جہاں باقی تمام چیزیں موجود ہیں۔ تبدیلی کرنے سے پہلے یقینی بنائیں کہ volume میں کافی جگہ ہے۔ N8N_PAYLOAD_SIZE_MAX آنے والے webhook payload کا زیادہ سے زیادہ حجم MiB (mebibytes) میں مقرر کرتا ہے، اور اس کی default قدر 16 ہے۔ اس قدر کو بڑھانے سے بڑی requests قبول ہو جاتی ہیں، لیکن اس کے نتیجے میں میموری کا اضافی خرچ آپ کو قبول کرنا ہوگا۔
جو بھی دوسری سروسز اسی host پر چل رہی ہیں، وہ اسی RAM کے لیے وسائل استعمال کرتی ہیں۔ اگر OOM kills کسی database container کے شامل کرنے کے بعد شروع ہوئیں تو database کو Docker میں یا host پر چلانا وہ trade-off ہے جو اب آپ کر رہے ہیں۔
Restart policy اور reboot کے بعد دوبارہ آغاز
جس container کے لیے restart policy مقرر نہ ہو، وہ exit ہونے کے بعد، اور host کے reboot ہونے کے بعد بھی، بند رہتا ہے۔ restart: unless-stopped دونوں صورتوں میں اسے دوبارہ چلا دیتا ہے، جبکہ آپ کے ہاتھ سے stop کیے گئے container کا احترام بھی کرتا ہے۔ restart: always جان بوجھ کر stop کیے گئے container کو بھی Docker کے اگلی بار start ہونے پر دوبارہ چلا دیتا ہے۔
n8n ایک health endpoint فراہم کرتا ہے، جس کا نام N8N_ENDPOINT_HEALTH سے متعین ہوتا ہے اور جو default طور پر healthz ہوتا ہے۔ پہلے اسے host سے check کریں تاکہ تصدیق ہو جائے کہ آپ کے instance پر path درست ہے۔
curl -fsS http://127.0.0.1:5678/healthz
docker exec n8n which wget curl
sudo systemctl is-enabled dockerhealthcheck اکیلا کسی چیز کو restart نہیں کرتا۔ Compose container کو unhealthy قرار دے کر وہیں رک جاتا ہے؛ restart policy container کے exit ہونے پر عمل کرتی ہے، جبکہ کسی container کے unhealthy ہونے کی وجہ سے اسے restart کرنے کے لیے external watcher درکار ہوتا ہے۔ ایسا healthcheck لکھنا جو واقعی کارروائی کرے اور reboot کے بعد stack کو دوبارہ start کرنا دونوں پہلوؤں کا احاطہ کرتے ہیں۔
وہ workflow جو n8n کے درست ہونے کے باوجود کبھی چلتا ہی نہیں
اس صورت میں کوئی banner ظاہر نہیں ہوتا اور restart بھی نہیں ہوتا۔ container چل رہا ہوتا ہے، editor کام کرتا ہے، لیکن متوقع run executions list میں موجود نہیں ہوتا۔ درج ذیل چار چیزیں چیک کریں۔
- workflow publish نہیں کیا گیا۔ Schedule Trigger استعمال کرنے والا workflow save اور publish کریں تاکہ اس کا production schedule چل سکے۔
- timezone آپ کے مطابق نہیں ہے۔ Schedule Trigger پہلے workflow timezone استعمال کرتا ہے، پھر اس وقت instance timezone استعمال کرتا ہے جب workflow timezone مقرر نہ ہو۔
GENERIC_TIMEZONEکی default قدرAmerica/New_Yorkہے؛ workflow timezone مقرر کریں یا instance default کو اپنی timezone پر تبدیل کریں۔ - run نے اپنی grace period گنوا دی۔ n8n 2.45.0 سے durable scheduler بطور default enabled ہے اور آئندہ runs کو database میں record کرتا ہے۔ Recorded runs restart کے بعد اپنی grace period کے اندر تاخیر سے چلتے ہیں؛ اس مدت کے بعد configured misfire policy طے کرتی ہے کہ انہیں skip کیا جائے یا catch-up run بنایا جائے۔ پرانا in-memory scheduler downtime کے دوران واجب ہونے والے runs کو skip کر دیتا ہے۔
- workflow خودکار طور پر deactivated ہو گیا۔
N8N_WORKFLOW_AUTODEACTIVATION_ENABLEDبطور default off ہے، اور جب یہ on ہو تو مسلسل crash ہونے والا workflow unpublished کر دیا جاتا ہے۔ اس کے بعد یہ بالکل ایسے دکھائی دیتا ہے جیسے اسے کبھی activate ہی نہ کیا گیا ہو۔
executions list کھولیں اور اسے اسی workflow کے مطابق filter کریں۔ Failed entry workflow کے مسئلے کی نشاندہی کرتی ہے۔ اگر یہ اسی box پر host کی گئی کسی دوسری service کے خلاف 429 کے ساتھ failed ہوئی ہو تو limit n8n کے بجائے اسی service کی ہے، اور SearXNG 429 walkthrough میں بتایا گیا ہے کہ اس کے اپنے rate limiter اور آپ کے server IP کو block کرنے والے engines میں فرق کیسے کیا جائے۔ کوئی entry موجود نہ ہونا اس وقت بھی ہو سکتا ہے جب execution saving disabled ہو یا pruning نے record حذف کر دیا ہو؛ اس لیے اسے trigger کا مسئلہ سمجھنے سے پہلے یہ settings چیک کریں۔
پہلے کیا تبدیل کریں
- کسی بھی فائل میں ترمیم کرنے سے پہلے اپنے container پر
STATUS،RestartCountاورOOMKilledپڑھیں۔ - اگر container چلتا رہا ہو تو n8n کی رسائی اور database کی readiness چیک کریں، پھر proxy، authentication، origin یا timeout errors کے لیے push connection کا جائزہ لیں۔
- اگر
OOMKilledدرست ہو تو container کی وہ limit مقرر کریں جس کا آپ نے جان بوجھ کر انتخاب کیا ہے، Node heap ceiling مقرر کرتے وقت اس سے نیچے کچھ گنجائش رکھیں، اور binary data کوfilesystemپر منتقل کریں۔ - اگر کچھ بھی trigger نہ ہوا ہو تو تصدیق کریں کہ workflow published ہے، اس کا مؤثر timezone آپ کے مطابق ہے، اور اس کی scheduler اور misfire settings آپ کی توقعات کے مطابق ہیں۔
ان میں سے زیادہ تر settings ایسی ہیں جو working install کے اوپر ایک بار مقرر کرنے کے بعد دوبارہ تبدیل نہیں کرنی پڑتیں۔ اگر آپ ابھی یہ install تیار کر رہے ہیں تو HTTPS کے ساتھ Docker پر n8n کی walkthrough وہ بنیادی مرحلہ ہے جس کے بعد یہ settings لاگو کی جاتی ہیں۔
FAQ
n8n container چلنے کے باوجود editor میں connection lost بینر کیوں دکھائی دیتا ہے؟
Editor execution progress stream کرنے کے لیے WebSocket کھلا رکھتا ہے۔ اگر reverse proxy Connection: Upgrade اور Upgrade: websocket headers آگے forward نہ کرے، یا upstream کے لیے HTTP/1.1 استعمال نہ کرے، تو upgrade مکمل نہیں ہوتا۔ نتیجتاً browser مسلسل reconnect کرتا رہتا ہے، جبکہ n8n درست حالت میں چلتا رہتا ہے۔ nginx میں proxy_set_header دونوں lines درکار ہیں، اور 1.29.7 سے پہلے کے releases میں proxy_http_version 1.1 بھی ضروری ہے۔ نئے releases میں HTTP/1.1 default طور پر استعمال ہوتا ہے۔ proxy_read_timeout کو اس کی default 60 seconds قدر سے زیادہ کرنے پر n8n کے periodic pings کے پہنچنے کے لیے کافی وقت ملتا ہے۔ صرف quiet workflows کی وجہ سے connection idle نہیں ہوتی۔ n8n invalid push requests اور authentication failures بھی مسترد کرتا ہے، اس لیے response اور application logs کا جائزہ لیں۔ sudo nginx -T سے configuration files چیک کریں اور تصدیق کریں کہ reload کامیاب ہوا ہے۔
Out of memory kill اور عام crash میں فرق کیسے معلوم کریں؟
docker inspect n8n | grep -iE 'OOMKilled|ExitCode|RestartCount' چلائیں اور OOMKilled flag پڑھیں۔ True کا مطلب ہے کہ Docker نے out of memory kill record کیا ہے۔ متاثرہ process کو آخری log entry لکھنے کا موقع نہیں ملتا، تاہم پہلے کے container logs پھر بھی مدد دے سکتے ہیں۔ اگر False ہو اور docker logs کے آخر میں fatal heap error موجود ہو تو اس سے ظاہر ہوتا ہے کہ Node.js نے اپنا V8 heap ختم کر دیا ہے۔ NODE_OPTIONS=--max-old-space-size=SIZE کو container limit سے کم numeric size کے ساتھ MiB میں set کریں، اور دیگر memory استعمال کے لیے گنجائش چھوڑیں۔ اس سے V8 old space محدود ہوتا ہے، لیکن یہ ضمانت نہیں دیتا کہ kernel OOM kill سے پہلے heap error ضرور آئے گا۔
کیا execution data prune کرنے سے disk space فوراً خالی ہو جاتی ہے؟
نہیں۔ EXECUTIONS_DATA_PRUNE پرانی executions کو deletion کے لیے نشان زد کرتا ہے، اور بعد کے pass میں انہیں حذف کیا جاتا ہے۔ یہ عمل EXECUTIONS_DATA_PRUNE_HARD_DELETE_INTERVAL میں مقرر schedule کے مطابق ہوتا ہے۔ SQLite میں file خالی ہونے والے pages کو filesystem کو واپس دینے کے بجائے دوبارہ استعمال کرتی ہے۔ اس لیے rows حذف ہونے کے بعد بھی disk پر file size کچھ وقت تک تبدیل نہیں ہوتا۔ EXECUTIONS_DATA_MAX_AGE اور EXECUTIONS_DATA_PRUNE_MAX_COUNT کو اپنے server کے مطابق values پر set کریں۔ پھر فوراً دوبارہ چیک کرنے کے بجائے اگلے دن size دیکھیں۔
n8n restart ہونے کے دوران میرا scheduled workflow کیوں نہیں چلا؟
Default طور پر n8n 2.45.0 سے فعال durable scheduler آنے والی runs کو database میں محفوظ کرتا ہے۔ اگر n8n اپنی grace period کے اندر واپس آ جائے تو recorded runs تاخیر سے چلتی ہیں۔ اس مدت کے بعد trigger کی misfire policy فیصلہ کرتی ہے کہ backlog skip کیا جائے یا catch-up run بنائی جائے۔ اپنا version، scheduler configuration اور Schedule Trigger options چیک کریں۔ پرانا in-memory scheduler استعمال کرنے والی instances downtime کے دوران due ہونے والی runs skip کر دیتی ہیں۔
کیا healthcheck، n8n کے response دینا بند کرنے پر اسے restart کر دے گا؟
خود سے نہیں۔ Compose healthcheck صرف container کو healthy یا unhealthy نشان زد کرتا ہے۔ Restart policy اس وقت عمل کرتی ہے جب container exit ہو۔ اس لیے restart: unless-stopped، exit کے بعد اور host reboot کے بعد اسے واپس چلا دیتا ہے، بشرطیکہ container کو جان بوجھ کر stop نہ کیا گیا ہو اور Docker start ہو رہا ہو۔ sudo systemctl is-enabled docker سے اس کی تصدیق کریں۔ صرف unhealthy status پر کارروائی کے لیے Docker سے باہر ایک watcher درکار ہے جو status پڑھ کر service کو restart کرے۔