VPS پر ntfy self-host کر کے server alerts بھیجیں
Docker Compose کے ساتھ VPS پر ntfy چلائیں، TLS فعال کریں، users اور ACLs سے topics محفوظ کریں، پھر cron اور systemd OnFailure سے alerts بھیجیں۔
self-hosted ntfy سرور کیا کرتا ہے
self-hosted ntfy سرور HTTP POST کو آپ کے فون پر push notification میں تبدیل کرتا ہے۔ آپ curl کے ذریعے پیغام publish کرتے ہیں، اور یہ Android app، iOS app، browser tab، یا کسی بھی ایسی چیز تک پہنچ جاتا ہے جو HTTP connection کو کھلا رکھ سکتی ہو۔ کسی client library کو install کرنے یا message broker چلانے کی ضرورت نہیں ہوتی۔
ntfy پیغامات کو topic کے ذریعے address کرتا ہے۔ topic URL path میں موجود ایک نام ہوتا ہے، جیسے https://ntfy.example.com/alerts، اور کسی کے اس پر publish کرتے ہی یہ وجود میں آ جاتا ہے۔ default install میں جس شخص کو یہ نام معلوم ہو، وہ topic کو پڑھ بھی سکتا ہے اور اس پر لکھ بھی سکتا ہے۔ اسی لیے project کی اپنی documentation topic name کا موازنہ password سے کرتی ہے۔ یہ model public ntfy.sh service کے لیے مناسب ہے۔ لیکن آپ کے backup failures والے server کے لیے یہ مناسب نہیں۔ اسی لیے یہ guide پہلا message بھیجے جانے سے پہلے authentication فعال کرتی ہے۔
شروع کرنے سے پہلے آپ کو کیا درکار ہے
آپ کو Ubuntu 24.04 یا Debian 13 چلانے والا VPS درکار ہے، جس پر Docker Engine اور Compose plugin موجود ہوں، ساتھ ہی ایک domain name اور بہت کم RAM بھی درکار ہے۔ ایک DNS (domain name system) A record بنائیں جو ntfy.example.com کو server کے public IP address کی طرف point کرے۔ اس کے بعد، کوئی اور کام کرنے سے پہلے تصدیق کریں کہ یہ resolve ہو رہا ہے۔
dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw statusdig کو آپ کے server کا IP دکھانا چاہیے۔ Certificate جاری کرنے کے لیے ضروری ہے کہ hostname، A یا AAAA record کے ذریعے public طور پر server پر resolve ہو۔ Port 80 کھلا رہتا ہے کیونکہ Let's Encrypt کے پیچھے موجود protocol ACME (automatic certificate management environment) اسے HTTP challenge کے لیے استعمال کرتا ہے۔ ntfy container کو خود کوئی public port نہیں ملتا۔
ntfy کی config فائل لکھیں
Docker image میں config فائل شامل نہیں ہوتی، اس لیے آپ اسے خود بنائیں گے۔ اس گائیڈ میں بعد کے ہر command میں اسی فائل سے settings پڑھی جائیں گی۔ پہلے اس user ID اور group ID کا پتا لگائیں جس کے تحت container چلے گا۔
id -u
id -g
sudo install -d -o "$(id -u)" -g "$(id -g)" /etc/ntfy /var/cache/ntfy /var/lib/ntfy
sudo nano /etc/ntfy/server.ymlbase-url: "https://ntfy.example.com"
listen-http: ":2586"
behind-proxy: true
cache-file: "/var/cache/ntfy/cache.db"
cache-duration: "12h"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
enable-login: true
enable-signup: falseان سطور میں سے چار بنیادی اہمیت رکھتی ہیں۔ base-url عین public HTTPS address ہونا چاہیے، کیونکہ ntfy اسے generated attachment links اور self-hosted iOS push notifications کے لیے استعمال کرتا ہے۔ listen-http: ":2586" container کے اندر تمام interfaces سے bind کرتا ہے۔ یہ بظاہر لاپروائی معلوم ہوتی ہے، لیکن درست ہے: container کا اپنا network namespace ہوتا ہے، اس لیے وہاں 127.0.0.1 سے bind کرنے پر port host سے ناقابل رسائی ہو جائے گا اور Docker کا published port کبھی connect نہیں کر سکے گا۔ auth-default-access: "deny-all" مکمل security posture متعین کرتا ہے، کیونکہ explicit grant کے بغیر یہ کسی کو read یا write کی اجازت نہیں دیتا۔ behind-proxy: true ntfy کو بتاتا ہے کہ client address X-Forwarded-For header سے لیا جائے، تاکہ rate limits reverse proxy کو ایک بہت مصروف client شمار کرنے کے بجائے حقیقی visitors کو شمار کریں۔
enable-login: true users کو web app یا API کے ذریعے sign in کرنے دیتا ہے۔ enable-signup false ہی رہے گا، کیونکہ private server پر self-service account creation اضافی مراحل کے ساتھ ایک کھلا دروازہ ہے۔
sudo chown "$(id -u):$(id -g)" /etc/ntfy/server.yml
sudo chmod 600 /etc/ntfy/server.ymlDocker Compose کے ساتھ ntfy چلائیں
اسے /opt/ntfy/compose.yaml میں درج کریں، اور 1000:1000 کو اوپر دکھائے گئے دو نمبروں id -u اور id -g سے تبدیل کریں۔
services:
ntfy:
image: binwiederhier/ntfy:v2.36.0
container_name: ntfy
command: serve
user: "1000:1000"
environment:
- TZ=UTC
volumes:
- /etc/ntfy:/etc/ntfy
- /var/cache/ntfy:/var/cache/ntfy
- /var/lib/ntfy:/var/lib/ntfy
ports:
- "127.0.0.1:2586:2586"
restart: unless-stoppedcd /opt/ntfy
sudo docker compose up -d
sudo docker compose logs ntfy
curl -s http://127.0.0.1:2586/v1/healthصحت مند server {"healthy":true,"role":"active"} کا جواب دیتا ہے۔ اس compose file میں دو تفصیلات جان بوجھ کر شامل کی گئی ہیں۔ image کو v2.36.0 پر pin کیا گیا ہے، جو November 1, 2026 تک current stable release ہے، latest پر نہیں، کیونکہ latest کے ساتھ اگلا docker compose pull current image download کرتا ہے، اور اس کے بعد docker compose up -d container کو اسی image کے ساتھ دوبارہ بناتا ہے؛ صرف pull کرنے سے چلنے والے server کا version تبدیل نہیں ہوتا۔ Pin کو پھر بھی update کرنا ضروری ہے۔ صرف October 2026 میں دس releases آئیں: October 7 کو v2.29.0، October 12 کو v2.30.0، October 16 کو v2.31.0 اور v2.31.1، October 18 کو v2.32.0، October 23 کو v2.33.0 اور v2.33.1، October 24 کو v2.34.0، October 30 کو v2.35.0، اور October 31 کو v2.36.0۔ v2.31.0 میں وہ messages ضائع ہونے کا مسئلہ حل کیا گیا جو message cache تک پہنچنے سے پہلے client کے reconnect ہونے پر پیدا ہوتا تھا، لیکن since=<message ID> کے ساتھ اس کے reconnects topic کے ہر message کو database سے پڑھتے ہیں، اور ntfy.sh نے اس version سے rollback کیا۔ v2.31.1 میں نئے index کے ذریعے یہ load درست کیا گیا، جبکہ v2.34.0 میں revoked یا deleted users کے کچھ subscriptions برقرار رہنے کا مسئلہ حل کیا گیا۔ v2.35.0 میں concurrent requests کے valid credentials کو anonymous سمجھنے کا مسئلہ اور SQLite پر Matrix push gateway authorization bypass درست کیا گیا، اس لیے پرانے pins کو v2.36.0 پر منتقل کریں۔ Port کو 127.0.0.1:2586:2586 کے طور پر publish کیا گیا ہے، اس لیے container صرف host کے loopback address سے قابل رسائی ہے۔ اس کے بجائے 2586:2586 لکھنے پر Docker آپ کے rules سے پہلے اپنے firewall rules شامل کر دیتا ہے۔ اس کا نتیجہ یہ ہوتا ہے کہ ufw status کے مطابق port closed ہونے کے باوجود port internet سے جواب دیتا ہے۔ یہ دونوں طریقے اگلے container پر بھی لاگو ہوتے ہیں جسے آپ شامل کریں گے: self-hosted RustDesk relay بھی اسی طرح اپنی image tag کو pin کرتا ہے، لیکن اسے loopback کے پیچھے نہیں چھپایا جا سکتا، کیونکہ اس کے signal اور relay ports کو internet سے جواب دینا ہوتا ہے۔
اگر curl Connection refused دکھائے تو container log پڑھیں۔ /var/lib/ntfy/user.db پر permission error کا مطلب ہے کہ user: line ان directories کے owner سے مطابقت نہیں رکھتی، اس لیے process اپنی database نہیں بنا سکتا اور exit ہو جاتا ہے۔ VPS کے لیے Docker Compose basics guide volume ownership اور restart policies کی مزید تفصیل فراہم کرتی ہے۔
Caddy کے ساتھ TLS شامل کریں
Caddy خود certificate کی درخواست اور renewal کرتا ہے۔ اس طرح working TLS (transport layer security) حاصل کرنے کا راستہ مختصر ہو جاتا ہے۔
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddy/etc/caddy/Caddyfile کے مندرجات کو تین سطروں سے replace کریں۔
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}sudo systemctl reload caddy
curl -s https://ntfy.example.com/v1/healthاسی {"healthy":true,"role":"active"} کو HTTPS پر کھولنے سے پورا path کام کرنے لگتا ہے۔ Caddy کی طرف سے آنے والا 502 عموماً اس بات کی نشاندہی کرتا ہے کہ ntfy listening نہیں کر رہا۔ `sudo ss -lntp | grep 2586 سے تصدیق کریں۔ اگر ntfy listening کر رہا ہو اور 502 برقرار رہے تو Caddy upstream error کو log کرتا ہے، مثلاً reset connection۔ Certificate error عموماً اس بات کی نشاندہی کرتا ہے کہ DNS record غلط ہے یا certificate validation port 80 یا 443 پر server تک نہیں پہنچ سکتی۔ Validation error کے لیے sudo journalctl -u caddy -n 50` دیکھیں۔ بعد میں دوسری service شامل کرنے کے لیے اسی Caddyfile میں ایک اور hostname block کافی ہوتا ہے۔ اسی طریقے سے Halcyon، آپ کی Jellyfin library کے لیے 90s video store front end اسی server کے دوسرے subdomain پر دستیاب ہو جاتا ہے۔
اگر آپ پہلے سے nginx چلا رہے ہیں تو ntfy کی دستاویز کردہ proxy settings نقل کریں: proxy_http_version 1.1، proxy_buffering off، proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for، اور کم از کم تین منٹ کے read اور send timeouts مقرر کریں۔ Subscriber listening کے دوران ایک HTTP connection کھلا رکھتا ہے۔ nginx کا default proxy_read_timeout، جو 60 seconds ہے، صرف دو reads کے درمیان گزرنے والے وقت کو شمار کرتا ہے۔ ntfy default طور پر ہر 45 seconds بعد keepalive message بھیجتا ہے (keepalive-interval)، تاکہ intermediaries inactivity کی وجہ سے connection بند نہ کریں۔ اس لیے quiet subscriber stock nginx کے پیچھے بھی connected رہتا ہے۔ زیادہ timeouts اضافی گنجائش فراہم کرتے ہیں، connection برقرار رکھنے کی بنیادی وجہ نہیں ہیں۔ اگر آپ keepalive-interval بڑھائیں تو اسے اپنے proxy کے read timeout سے کم رکھیں۔
صارف بنائیں اور topics تک رسائی محدود کریں
Authentication فعال ہے، لیکن فی الحال کسی کو بھی کسی چیز تک رسائی حاصل نہیں۔ یہی مطلوب ہے۔ اپنے لیے ایک admin account اور scripts کے لیے ایک machine account بنائیں۔ یہ commands container کے اندر سے /etc/ntfy/server.yml پڑھتی ہیں، اسی لیے config file کو volume mount کے طور پر استعمال کیا گیا ہے۔
sudo docker compose exec ntfy ntfy user add --role=admin admin
sudo docker compose exec ntfy ntfy user add robot
sudo docker compose exec ntfy ntfy user listہر user add command password طلب کرتی ہے۔ admin access list کو نظرانداز کرتا ہے اور ہر topic کو پڑھ اور لکھ سکتا ہے، اس لیے یہ account صرف اپنے اور phone app کے لیے رکھیں۔ robot ایک عام user ہے جسے اس وقت تک کسی چیز تک رسائی حاصل نہیں جب تک آپ کچھ اجازتیں نہ دیں۔
sudo docker compose exec ntfy ntfy access robot alerts write
sudo docker compose exec ntfy ntfy access robot "alerts_*" write
sudo docker compose exec ntfy ntfy accessACL (access control list) entry میں user، topic اور permission شامل ہوتے ہیں۔ topic یا تو literal name ہوتا ہے یا ایسا pattern جس میں * کسی بھی چیز سے match کرتا ہے۔ اس طرح alerts_* ایک ہی command کے بغیر alerts_backup اور alerts_db دونوں کو شامل کر لیتا ہے۔ permission write کا مطلب صرف publish ہے، اس لیے cron job سے چوری کیا گیا token subscribe نہیں کر سکتا اور بھیجا ہوا data دوبارہ نہیں پڑھ سکتا۔ خصوصی username everyone یہ طے کرتا ہے کہ unauthenticated visitor کیا کر سکتا ہے۔ deny-all کو default کے طور پر استعمال کرتے ہوئے عموماً اسے کسی چیز کو دانستہ طور پر public کرنے کے لیے استعمال کریں گے، مثلاً ntfy access everyone status read۔ جب anonymous visitors کو کسی topic سے واضح طور پر روکنا ہو تو یہ deny بھی قبول کرتا ہے۔
Scripts میں اپنا password نہیں بلکہ token رکھیں۔
sudo docker compose exec ntfy ntfy token add robotیہ command tk_ سے شروع ہونے والا token دکھاتی ہے۔ token کو اسی user کی تمام permissions حاصل ہوتی ہیں جس سے وہ وابستہ ہے۔ اس لیے یہ token alerts topics پر publish کر سکتا ہے اور اس کے علاوہ کچھ نہیں کر سکتا۔ ntfy token list موجودہ entries دکھاتا ہے، جبکہ ntfy token remove user کا password تبدیل کیے بغیر ایک entry منسوخ کرتا ہے۔
اپنا پہلا پیغام بھیجیں اور ثابت کریں کہ lock کام کر رہا ہے
شروع میں تصدیق کریں کہ door بند ہے۔
curl -s -o /dev/null -w '%{http_code}\n' -d "hello" https://ntfy.example.com/alertsیہ 403 دکھاتا ہے، اور 403 درست جواب ہے: auth-default-access: "deny-all" anonymous publish کو مسترد کرتا ہے۔ اب ایک حقیقی پیغام بھیجیں۔
curl -H "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN" \
-H "Title: Nightly backup finished" \
-H "Priority: default" \
-H "Tags: white_check_mark" \
-d "42 GB copied in 11 minutes" \
https://ntfy.example.com/alertsserver stored message کو JSON کے طور پر واپس بھیجتا ہے۔ اس سے معلوم ہوتا ہے کہ پیغام قبول کیا گیا، ضائع نہیں ہوا۔ Title پہلی نمایاں سطر ہے۔ Priority کی قدر 1 سے 5 تک ہو سکتی ہے، یا نام کے ذریعے min سے urgent تک دی جا سکتی ہے۔ یہ طے کرتی ہے کہ phone sound چلائے گا یا نہیں۔ جب نام کسی معروف emoji short code سے match ہو تو Tags notification میں emoji بن جاتے ہیں، ورنہ plain text رہتے ہیں۔
terminal سے کسی topic کو دیکھنے کے لیے اسے stream کریں:
curl -s -u admin https://ntfy.example.com/alerts/rawcurl password طلب کرتا ہے۔ ہر پیغام ایک سطر کے طور پر آتا ہے، اور وقفے وقفے سے ظاہر ہونے والی خالی سطریں keepalive messages ہوتی ہیں۔ browser میں https://ntfy.example.com کھول کر اسی account سے sign in کرنے پر اسی stream کا web app version مل جاتا ہے۔
Rate limits مقرر کریں تاکہ کوئی ایک script server کو flood نہ کر سکے
Default طور پر ہر visitor کو 60 requests کا bucket ملتا ہے، جو ہر 5 seconds میں 1 request کے حساب سے دوبارہ بھرا جاتا ہے۔ Private server کے لیے یہ حد کافی زیادہ ہے، اور retry loop میں پھنسی ہوئی script اسے مکمل طور پر استعمال کر لے گی۔ server.yml میں limits شامل کریں۔
visitor-request-limit-burst: 30
visitor-request-limit-replenish: "10s"
visitor-message-daily-limit: 500sudo docker compose restart ntfyحد سے زیادہ requests بھیجنے والے visitor کو delivered message کے بجائے HTTP 429 ملتا ہے۔ Limit ہر visitor address کے حساب سے شمار ہوتی ہے۔ اسی لیے behind-proxy: true اتنا اہم ہے: اس کے بغیر ntfy کو صرف Caddy کا address نظر آتا ہے، ہر client ایک ہی visitor شمار ہوتا ہے، اور ایک noisy script وہ bucket ختم کر دیتی ہے جسے آپ کا phone اور آپ کے دوسرے servers بھی share کرتے ہیں۔ v2.36.0 سے daily counts restarts کے بعد user database میں برقرار رہتے ہیں، اور ہر visitor کا allowance midnight UTC پر نہیں بلکہ اپنے الگ 24-hour cycle پر reset ہوتا ہے۔
کرون جاب کی ناکامی کی اطلاع
ٹوکن کو command line میں شامل نہ کریں۔ ps aux سسٹم پر چلنے والے ہر process کی مکمل command line ہر user کو دکھاتا ہے، اس لیے -H کے ذریعے بھیجا گیا ٹوکن curl کے چلنے تک کسی بھی local account کو نظر آ سکتا ہے۔ curl config file اس مسئلے سے بچاتی ہے۔
sudo install -d -m 700 /etc/ntfy-alert
printf 'header = "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN"\n' | sudo tee /etc/ntfy-alert/curlrc
sudo chmod 600 /etc/ntfy-alert/curlrcاب job کو wrapper میں رکھیں۔ اسے /usr/local/bin/backup-with-alert.sh کے نام سے محفوظ کریں اور chmod 750 کریں۔
#!/bin/bash
out=$(/usr/local/bin/backup.sh 2>&1)
code=$?
if [ "$code" -ne 0 ]; then
printf '%s' "$out" | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
-H "Title: backup.sh failed with exit $code" \
-H "Priority: high" \
-H "Tags: warning" \
--data-binary @- \
https://ntfy.example.com/alerts
fi
exit "$code"17 3 * * * /usr/local/bin/backup-with-alert.sh >> /var/log/backup-alert.log 2>&1$? کو command کے فوراً بعد والی line پر capture کیا جاتا ہے، کیونکہ اس کے بعد چلنے والی اگلی command اسے overwrite کر دے گی۔ output کو tail -c 1000 کے ذریعے بھیجا جاتا ہے، کیونکہ ntfy message size کی زیادہ سے زیادہ حد نافذ کرتا ہے اور notification log viewer نہیں ہوتی۔ اختتامی exit "$code" اصل status برقرار رکھتا ہے، اس لیے اس job کو monitor کرنے والا کوئی بھی دوسرا نظام اب بھی failure دیکھتا ہے۔ پوری ترتیب کی جانچ کے لیے ایک run میں script کو /bin/false کی طرف point کریں۔
ایسا failure branch جو کبھی execute ہی نہ ہو، alerting نہ ہونے سے بھی بدتر ہے، کیونکہ اس سے یہ غلط تاثر ملتا ہے کہ خاموشی کا مطلب success ہے۔ Cron آپ کے job کو تقریباً خالی environment اور login shell کے مقابلے میں کہیں مختصر PATH فراہم کرتا ہے، اس لیے جو script آپ ہاتھ سے چلانے پر کام کرتی ہے وہ curl line تک پہنچنے سے پہلے ہی fail ہو سکتی ہے۔ کرون جاب کے نہ چلنے کی وجوہات پر گائیڈ ان environment مسائل کی وضاحت کرتی ہے۔ ہر جگہ absolute paths استعمال کریں، اور پہلے scheduled run کے بعد log file پڑھیں؛ محض اندازہ نہ لگائیں۔
systemd unit ناکام ہونے پر اطلاع
Cron مقررہ کاموں کے لیے کافی ہے۔ طویل عرصے تک چلنے والی services کو OnFailure= درکار ہوتا ہے، جسے systemd اس وقت چلاتا ہے جب کوئی unit failed حالت میں داخل ہو۔ ایک template unit بنائیں اور اسے سرور کی ہر service کے لیے دوبارہ استعمال کریں۔ اسے /etc/systemd/system/ntfy-unit-failed@.service کے طور پر محفوظ کریں۔
[Unit]
Description=Send an ntfy alert because %i failed
[Service]
Type=oneshot
ExecStart=/usr/local/bin/ntfy-unit-failed %iپھر /usr/local/bin/ntfy-unit-failed چلائیں اور mode 750 مقرر کریں:
#!/bin/bash
unit="$1"
journalctl -u "$unit" -n 15 --no-pager -o cat | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
-H "Title: $unit failed on $(hostname -s)" \
-H "Priority: urgent" \
-H "Tags: rotating_light" \
--data-binary @- \
https://ntfy.example.com/alertsاسے drop-in کے ذریعے کسی service کے ساتھ منسلک کریں، تاکہ package upgrade آپ کی ترمیم overwrite نہ کر سکے۔
sudo systemctl edit myapp.service[Unit]
OnFailure=ntfy-unit-failed@%n.service%n مکمل unit name میں تبدیل ہوتا ہے، اس لیے instantiated unit ntfy-unit-failed@myapp.service.service بن جاتا ہے، جبکہ template کے اندر %i، myapp.service کو script کے پہلے argument کے طور پر فراہم کرتا ہے۔ اسی وجہ سے ایک template ہر unit کے لیے استعمال ہو سکتا ہے۔ کسی جان بوجھ کر ناکام ہونے والی unit کے ذریعے تصدیق کریں۔ اسے /etc/systemd/system/ntfy-selftest.service کے طور پر محفوظ کریں۔
[Unit]
Description=Deliberately failing unit
OnFailure=ntfy-unit-failed@%n.service
[Service]
Type=oneshot
ExecStart=/bin/falsesudo systemctl daemon-reload
sudo systemctl start ntfy-selftest.servicestart command non-zero status کے ساتھ ختم ہوتی ہے اور Job for ntfy-selftest.service failed because the control process exited with error code ظاہر کرتی ہے۔ فون کو تقریباً ایک سیکنڈ بعد اطلاع دینی چاہیے۔ اس کے بعد test unit حذف کر دیں۔
ایک اہم مسئلے پر توجہ دیں۔ OnFailure= صرف اس وقت چلتا ہے جب کوئی unit failed حالت تک پہنچے، جبکہ خودکار restart کے دوران RestartMode=direct اس حالت کو چھوڑ دیتا ہے، اس لیے failure handler بھی نہیں چلتا۔ default RestartMode=normal کے ساتھ خودکار restarts failed حالت سے گزرتے ہیں۔ StartLimitBurst اور StartLimitIntervalSec یہ متعین کرتے ہیں کہ بار بار ہونے والی starts کو کب مسترد کیا جائے؛ انہیں اس طرح مقرر کریں کہ crash loop آخرکار رک جائے۔ اوپر بیان کردہ cron pattern کے لیے timers زیادہ بہتر متبادل ہیں، کیونکہ timer کی service unit اسی OnFailure= drop-in کو support کرتی ہے، اور VPS پر systemd services اور timers کی رہنمائی ایک کو تبدیل کرنے کا طریقہ بیان کرتی ہے۔
اسی topic کے ساتھ uptime monitor کو مربوط کریں
Uptime Kuma، self-hosted status monitor میں ntfy notification type موجود ہے۔ Settings کھولیں، پھر Notifications، پھر Setup Notification پر جائیں، Ntfy منتخب کریں، server URL کو https://ntfy.example.com اور topic کو alerts پر set کریں، priority منتخب کریں، اور robot access token paste کریں۔ Save کرنے سے پہلے test notification بھیجیں، کیونکہ topic کا غلط نام ایسے write grant پر error دیتا ہے جس میں وہ شامل نہ ہو۔
اس انتظام کی واضح حد یہ ہے: اسی VPS پر چلنے والا monitor آپ کو یہ نہیں بتا سکتا کہ VPS down ہے، اور ntfy یہ اطلاع deliver نہیں کر سکتا کہ ntfy down ہے۔ Monitor کو مختلف machine پر چلائیں، اور اسے دوسرا notification channel، مثلاً email، بھی دیں تاکہ وہ خود ntfy کی نگرانی کرنے والے monitor کے لیے بھی alerts بھیج سکے۔ Uptime Kuma کا Push monitor type دوسری blind spot کو cover کرتا ہے: کامیاب run کے بعد آپ کا cron job push URL کو call کرتا ہے، اور جب یہ calls آنا بند ہو جائیں تو Kuma alert بھیجتا ہے۔ Failure branch صرف اس وقت چلتی ہے جب job run ہو، اس لیے یہ اس job کے بارے میں کچھ نہیں بتاتی جو کبھی start ہی نہ ہوئی ہو۔
کیا self-hosted ntfy Android اور iPhone پر کام کرتا ہے؟
Android پر جواب بلاشرط ہاں ہے۔ Google Play یا F-Droid سے ایپ install کریں، Settings کھولیں، default server کو https://ntfy.example.com پر set کریں، user management screen میں اپنا account شامل کریں، پھر alerts کو subscribe کریں۔ Instant delivery ایک foreground service چلاتی رہتی ہے، اس لیے phone کے doze mode میں ہونے کے باوجود messages پہنچتے رہتے ہیں۔ اس کے ساتھ دکھائی دینے والی مستقل notification، foreground services کے لیے Android کی requirement ہے، bug نہیں۔ F-Droid build میں Firebase code بالکل شامل نہیں، اس لیے ہر subscription instant delivery استعمال کرتی ہے۔ ntfy، UnifiedPush distributor کے طور پر بھی کام کر سکتا ہے۔ یہ Google کی push service کا open replacement ہے، اس لیے UnifiedPush کو support کرنے والی دوسری apps بھی آپ کے server کے ذریعے delivery کر سکتی ہیں۔
Official iOS app میں یہ ایک ایسی dependency کے ساتھ کام کرتا ہے جسے آپ ختم نہیں کر سکتے۔ iOS background میں جانے والی app کو suspend کر دیتا ہے۔ Apple کے اجازت یافتہ background modes، جیسے audio چلانا، location updates وصول کرنا، اور scheduled tasks process کرنا، کسی app کو آپ کے server سے message کا انتظار کرتے رہنے کی اجازت نہیں دیتے۔ اس لیے app کو فوری طور پر wake کرنے کے لیے APNs (Apple push notification service) کے ذریعے notification بھیجنا ضروری ہے۔ صرف وہی provider app کو notification بھیج سکتا ہے جس کے credentials اس app کے لیے authorized ہوں۔ اس لیے آپ کا server official app تک براہ راست نہیں پہنچ سکتا۔ ntfy اس مسئلے کو relay کے ذریعے حل کرتا ہے۔ آپ کا server message ID رکھنے والا poll_request ntfy.sh کو بھیجتا ہے۔ ntfy.sh اسے Firebase اور APNs کے ذریعے forward کرتا ہے تاکہ app wake ہو جائے۔ اس کے بعد app آپ کے server سے message body fetch کرتی ہے۔
upstream-base-url: "https://ntfy.sh"اس کی لاگت کو واضح طور پر سمجھیں۔ Message content آپ کے اپنے box پر رہتا ہے، لیکن message پہنچنے کا واقعہ اور اس کی ID ایسے infrastructure سے گزرتے ہیں جسے آپ خود نہیں چلاتے۔ اس setting کے بغیر، self-hosted server سے iPhone پر notifications آخرکار پہنچ جاتی ہیں، لیکن ntfy کی documentation خبردار کرتی ہے کہ تاخیر کئی گھنٹوں تک ہو سکتی ہے، کیونکہ app کو بروقت wake کرنے والی کوئی چیز موجود نہیں ہوتی۔ ntfy.sh relay کے بغیر native iOS app استعمال کرنے کے لیے app کو اپنے Apple developer account اور اپنی APNs keys کے ساتھ خود build اور ship کریں۔ اس کے لیے سالانہ fee ادا کرنی ہوگی اور ہر update کے لیے app دوبارہ build کرنی ہوگی۔ ایک اور راستہ iOS 16.4 یا اس کے بعد کے versions پر ntfy کی PWA استعمال کرنا ہے۔ اسے home screen پر شامل کریں اور اپنے server پر Web Push configure کریں۔ اس سے ntfy.sh relay سے گریز ہوتا ہے، لیکن browser کا push infrastructure پھر بھی استعمال ہوتا ہے۔ اگر relay آپ کے استعمال کے لیے قابل قبول نہیں، تو alerting کو Android یا desktop web app تک محدود رکھیں۔
Backups، upgrades اور image کو pin کرنا
دو paths دوبارہ generate نہیں کیے جا سکتے: /etc/ntfy/server.yml اور /var/lib/ntfy/user.db۔ دوسرے path میں ہر user، password hash، ACL entry اور token موجود ہوتا ہے، اس لیے اسے private key کی طرح محفوظ رکھیں۔
sudo tar czf ntfy-backup.tgz -C / etc/ntfy var/lib/ntfy
sudo chmod 600 ntfy-backup.tgzاس file کی copy server سے باہر رکھیں۔ cache.db میں recent messages موجود ہوتے ہیں؛ cache-duration کے ساتھ یہ 12 hours کے messages ہوتے ہیں، اور بعد میں delivery کے لیے scheduled ہر message بھی شامل ہوتا ہے، جو delivery کے 12 hours بعد تک برقرار رہتا ہے۔ اگر آپ پہلے سے messages schedule نہیں کرتے تو اسے کھونے سے کوئی اہم محفوظ شدہ data ضائع نہیں ہوتا۔ Upgrade کرنے کے لیے compose file میں tag edit کریں، image pull کریں، اور container دوبارہ بنائیں۔
sudo docker compose pull
sudo docker compose up -d
curl -s https://ntfy.example.com/v1/healthپہلے release notes پڑھیں۔ SQLite databases start کے وقت migrate ہوتی ہیں، اس لیے schema change کے بعد older tag پر rollback محفوظ نہیں ہوتا۔ مثال کے طور پر v2.31.1 میں message cache کو schema version 17 پر منتقل کیا گیا، اور اس کے upgrade notes کے مطابق v2.31.0 یا اس سے پہلے کے version پر downgrade کرنے کے لیے اس version کو دستی طور پر دوبارہ 16 پر set کرنا ہوگا۔ v2.36.0 پر upgrade کرنے سے سب کے موجودہ daily counts ایک بار reset ہو جاتے ہیں۔ جو backup آپ نے ابھی لیا ہے اسے نئی version کے ایک دن تک چلنے تک محفوظ رکھیں۔ Notes میں behaviour changes بھی درج ہوتے ہیں۔ v2.31.0 کے بعد since=<message ID> کے ساتھ reconnect کرنے والا client اسی second میں publish کیے گئے messages بھی وصول کرتا ہے، اس لیے اسے duplicate message نظر آ سکتا ہے۔ ntfy apps اور web app message ID کے ذریعے duplicates خارج کر دیتے ہیں، لیکن آپ کی اپنی وہ script جو topic کو replay کرتی ہے، اسے بھی یہی کام کرنا ہوگا۔ اس server پر موجود ہر service کے paths کی ایک مختصر فہرست ہوتی ہے جنہیں دوبارہ generate نہیں کیا جا سکتا، اور PhotoPrism اور Immich کا موازنہ اسی نوعیت کے VPS پر photo library کے لیے اس فہرست اور متعلقہ backup commands کی وضاحت کرتا ہے۔
Gotify اور Apprise
Gotify نسبتاً چھوٹا اختیار ہے: اس میں ایک binary، web UI اور Android app شامل ہیں، اور پیغامات application کے لحاظ سے منظم کیے جاتے ہیں۔ یہ ایسے private box کے لیے موزوں ہے جہاں واحد target Android ہو۔ Apprise ایک Python library اور command line tool ہے۔ اس کے لیے الگ Apprise API server بھی دستیاب ہے۔ یہ ایک ہی پیغام کو ntfy سمیت سو سے زیادہ services تک بھیج سکتا ہے، اس لیے یہ ایسے script کے لیے موزوں ہے جسے بیک وقت کئی مقامات تک پہنچنا ہو۔ ntfy آپ کو server، HTTP API اور دونوں mobile platforms کے لیے apps فراہم کرتا ہے۔ اسی وجہ سے rented server سے alerting کے لیے عموماً ntfy تجویز کیا جاتا ہے۔
FAQ
میرے ntfy server پر publishing کرنے سے 403 کیوں آتا ہے؟
auth-default-access: "deny-all" کو server.yml کے ساتھ استعمال کرنے پر anonymous publishing مسترد ہو جاتی ہے، اور یہی مطلوبہ رویہ ہے۔ -u user:pass یا -H "Authorization: Bearer tk_..." کے ساتھ credentials بھیجیں۔ اگر آپ پہلے ہی token بھیج رہے ہیں اور پھر بھی 403 موصول ہوتا ہے تو دیکھیں کہ اس user کے لیے topic پر write کی اجازت دینے والا ACL entry موجود ہے یا نہیں: matching entry نہ ہونے کی صورت میں read-only یا deny publishing مسترد کر دیتا ہے۔ v2.34.0 میں ایک ہی IP سے آنے والی بیک وقت requests کے باعث درست credentials کو بھی anonymous سمجھا جا سکتا تھا؛ v2.35.0 میں یہ bug درست کر دیا گیا ہے۔ اس لیے کبھی کبھار آنے والے 403 کو ACL کے مسئلے کا ثبوت سمجھنے سے پہلے upgrade کریں۔ مکمل فہرست دکھانے کے لیے ntfy access چلائیں۔ یاد رکھیں کہ write grant سے subscribe کرنے کی اجازت نہیں ملتی، اس لیے جو account publishing کامیابی سے کرتا ہے اسے اسی topic کو پڑھنے کی کوشش پر پھر بھی مسترد کیا جائے گا۔
کیا self-hosted ntfy server کے ساتھ iPhone پر notifications کام کرتی ہیں؟
Official iOS app استعمال کرنے پر یہ notifications relay کے ذریعے کام کرتی ہیں۔ Suspended iPhone app کو بروقت جگانے کے لیے notification کو APNs (Apple push notification service) کے ذریعے آنا ہوتا ہے۔ Official app کو notification بھیجنے کے لیے اس کے publisher کے push credentials درکار ہوتے ہیں، اس لیے ntfy ایک poll_request بھیجتا ہے جس میں message ID شامل ہوتی ہے۔ ntfy.sh اسے device تک relay کرتا ہے۔ server.yml میں upstream-base-url: "https://ntfy.sh" set کریں اور container restart کریں۔ Message body پھر بھی آپ کے server سے fetch ہوتی ہے۔ اس setting کے بغیر iOS notifications آخرکار موصول ہو جاتی ہیں، لیکن ntfy کی docs کے مطابق تاخیر کئی گھنٹے تک ہو سکتی ہے۔ iOS 16.4 یا اس کے بعد کے ورژن میں، جب آپ کے server پر Web Push configured ہو، PWA ایک اور طریقہ فراہم کرتی ہے۔
میرے cron job کا ntfy alert کبھی کیوں نہیں پہنچا؟
پہلے curl line کو الگ سے چلائیں تاکہ ثابت ہو جائے کہ token اور topic درست ہیں۔ اگر یہ manually کام کرتی ہے لیکن cron سے نہیں چلتی تو failure alert سے پہلے کے مرحلے میں ہے: cron jobs کو minimal environment اور مختصر PATH کے ساتھ چلاتا ہے، اس لیے bare name سے command چلانے والی script curl line تک پہنچنے سے پہلے ختم ہو سکتی ہے۔ Absolute paths استعمال کریں، job کا output log file میں redirect کریں، اور اگلی run کے بعد وہ file پڑھیں۔ Delivery کے بجائے 429 response ملنے کا مطلب ہے کہ کسی limit نے request مسترد کر دی۔ عموماً script بہت تیزی سے retry کر رہی ہوتی ہے، لیکن وہ visitor بھی اسی طرح مسترد کیا جاتا ہے جس نے daily quota استعمال کر لیا ہو، مثلاً اوپر set کی گئی message limit؛ یہ ایک ہی request کی صورت میں بھی ہوتا ہے۔
کیا مجھے ntfy کو public internet پر expose کرنا چاہیے؟
Phone apps کو mobile networks سے ntfy تک پہنچنے کی ضرورت ہوتی ہے، اس لیے auth-default-access: "deny-all" اور per-topic ACLs کے ساتھ public HTTPS endpoint معمول کی configuration ہے۔ یہ اس وقت محفوظ ہے جب کوئی بھی topic everyone کے ذریعے readable نہ ہو۔ VPN-only instance اس وقت مناسب ہے جب ہر subscriber ایسی machine ہو جسے آپ control کرتے ہوں۔ Phones کے لیے یہ طریقہ موزوں نہیں، کیونکہ app صرف tunnel کے فعال ہونے پر notifications وصول کرتی ہے؛ اس لیے phone کے دوبارہ connect ہونے تک alerts queue میں جمع رہتے ہیں۔