SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor

নিজের সার্ভারে ntfy সেটআপ করার নিয়ম

Docker Compose ব্যবহার করে নিজের VPS-এ ntfy সার্ভার হোস্ট করুন। TLS কনফিগারেশন, ACL এবং ইউজার অথেন্টিকেশন সেটআপ করে cron ও systemd থেকে সরাসরি পুশ নোটিফিকেশন পাওয়ার উপায় জানুন।

একটি self-hosted ntfy সার্ভার যা করে

একটি self-hosted ntfy সার্ভার একটি HTTP POST অনুরোধকে আপনার ফোনে push notification হিসেবে রূপান্তর করে। আপনি curl ব্যবহার করে বার্তা পাঠান এবং সেটি Android অ্যাপ, iOS অ্যাপ, ব্রাউজার ট্যাব অথবা HTTP সংযোগ খোলা রাখতে সক্ষম এমন যেকোনো ডিভাইসে পৌঁছে যায়। এর জন্য কোনো client library ইনস্টল করতে হয় না এবং কোনো message broker চালানোর প্রয়োজন নেই।

ntfy বার্তাগুলোকে topic-এর মাধ্যমে চিহ্নিত করে। একটি topic হলো URL path-এর একটি নাম, যেমন https://ntfy.example.com/alerts, এবং কেউ এতে বার্তা পাঠানোর সাথে সাথেই এটি তৈরি হয়ে যায়। ডিফল্ট ইনস্টলেশনে, যে কেউ এই নামটি জানলে topic-টি পড়তে বা এতে লিখতে পারে, যে কারণে প্রকল্পের নিজস্ব নথিপত্রে topic-এর নামকে পাসওয়ার্ডের সাথে তুলনা করা হয়েছে। পাবলিক ntfy.sh সার্ভিসের জন্য এই মডেলটি ঠিক আছে। কিন্তু আপনার ব্যাকআপ ব্যর্থতার মতো সংবেদনশীল তথ্য বহনকারী সার্ভারের জন্য এটি নিরাপদ নয়, তাই এই নির্দেশিকায় প্রথম বার্তা পাঠানোর আগেই authentication চালু করা হয়েছে।

শুরু করার আগে যা প্রয়োজন

আপনার একটি VPS প্রয়োজন, যেখানে Ubuntu 24.04 বা Debian 13, Docker Engine এবং Compose plugin ইনস্টল করা আছে। একটি domain name এবং অল্প RAM-ও প্রয়োজন। server-এর public IP address-এ নির্দেশ করে এমন একটি DNS (domain name system) A record তৈরি করুন, যেখানে ntfy.example.com থাকবে। এরপর অন্য কোনো কাজ করার আগে নিশ্চিত করুন যে এটি সঠিকভাবে resolve হচ্ছে।

dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw status

dig-এ আপনার সার্ভারের IP দেখাতে হবে। Certificate issuance-এর জন্য A বা AAAA record-এর মাধ্যমে hostname-টি publicভাবে সার্ভারে resolve হতে হবে। Port 80 খোলা রাখতে হবে, কারণ Let's Encrypt-এর পেছনে থাকা protocol ACME (automatic certificate management environment) HTTP challenge-এর জন্য এটি ব্যবহার করে। ntfy container নিজে কোনো public port পাবে না।

ntfy কনফিগারেশন ফাইল লিখুন

Docker image-এ কোনো কনফিগারেশন ফাইল থাকে না, তাই আপনাকেই একটি তৈরি করতে হবে। এই গাইডের পরের প্রতিটি command এই ফাইল থেকে তথ্য পড়বে। প্রথমে container কোন user ID এবং group ID হিসেবে চলবে, তা খুঁজে বের করুন।

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.yml
base-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 link এবং self-hosted iOS push notification তৈরি করে। listen-http: ":2586" container-এর ভেতরে সব interface-এ bind করে। এটি অসতর্কতা মনে হলেও সঠিক সেটিং: container-এর নিজস্ব network namespace আছে। তাই সেখানে 127.0.0.1-এ bind করলে host থেকে port-এ পৌঁছানো যাবে না এবং Docker-এর published port কখনো সংযোগ করতে পারবে না। auth-default-access: "deny-all"-ই সম্পূর্ণ security policy নির্ধারণ করে, কারণ explicit grant না থাকলে এটি কাউকে read বা write করতে দেয় না। behind-proxy: true ntfy-কে X-Forwarded-For header থেকে client address নিতে বলে। ফলে rate limit-এ reverse proxy-কে একক অত্যন্ত ব্যস্ত client হিসেবে গণনা না করে প্রকৃত visitor-দের গণনা করা হয়।

enable-login: true ব্যবহারকারীদের 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.yml

Docker 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-stopped
cd /opt/ntfy
sudo docker compose up -d
sudo docker compose logs ntfy
curl -s http://127.0.0.1:2586/v1/health

সুস্থ সার্ভার {"healthy":true,"role":"active"}-এর উত্তর দেয়। ওই compose file-এ দুটি বিষয় ইচ্ছাকৃতভাবে করা হয়েছে। Image-টি v2.36.0-এ pin করা আছে, যা November 1, 2026 অনুযায়ী বর্তমান stable release। latest ব্যবহার করা হয়নি, কারণ latest থাকলে পরবর্তী docker compose pull current image download করে এবং তার পরের docker compose up -d container-টি সেটি দিয়ে পুনরায় তৈরি করে; শুধু pull করলে চলমান server version পরিবর্তন হয় না। Pin করা version-ও update করতে হয়। শুধু October 2026-এই দশটি release এসেছে: 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 এমন message হারিয়ে যাওয়ার সমস্যা ঠিক করে, যেগুলো message cache-এ পৌঁছানোর আগে কোনো client reconnect করলে হারিয়ে যেত। তবে since=<message ID>-সহ reconnect করলে এটি database থেকে topic-এর প্রতিটি message পড়ে, এবং ntfy.sh এই version থেকে rollback করেছিল। v2.31.1 নতুন index ব্যবহার করে এই load কমায়। v2.34.0 revoked বা deleted user-এর কিছু subscription ধরে রাখার সমস্যা ঠিক করে। v2.35.0 এমন concurrent request-এর সমস্যা ঠিক করে, যেখানে valid credential-কে anonymous হিসেবে ধরা হতো। SQLite-এ Matrix push gateway authorization bypass-ও এটি ঠিক করে। তাই পুরোনো pin-গুলো v2.36.0-এ সরান। Port-টি 127.0.0.1:2586:2586 হিসেবে publish করা হয়েছে, তাই container-এ শুধু host-এর loopback address থেকে পৌঁছানো যায়। এর বদলে 2586:2586 লিখলে Docker আপনার rule-এর আগে নিজের firewall rule বসায়। ফলে ufw status port-টি closed বললেও Internet থেকে port-টি উত্তর দেয়। পরের container যোগ করলেও এই দুটি নিয়ম প্রযোজ্য হবে: self-hosted RustDesk relay একইভাবে image tag pin করে, কিন্তু এটিকে loopback-এর আড়ালে রাখা যায় না, কারণ এর signal ও relay port-কে Internet থেকে উত্তর দিতে হয়।

curl Connection refused মুদ্রণ করলে container log পড়ুন। /var/lib/ntfy/user.db-এ permission error-এর অর্থ user: line-টি ওই directory-গুলোর owner-এর সঙ্গে মেলে না। তাই process নিজের database তৈরি করতে পারে না এবং exit করে। VPS-এর Docker Compose basics guide-এ volume ownership ও restart policy সম্পর্কে আরও বিস্তারিত আছে।

Caddy দিয়ে সামনে TLS বসান

Caddy নিজেই certificate-এর জন্য অনুরোধ করে এবং তা renew করে। কাজের 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-এর বিষয়বস্তু মুছে তিনটি line লিখুন।

ntfy.example.com {
    reverse_proxy 127.0.0.1:2586
}
sudo systemctl reload caddy
curl -s https://ntfy.example.com/v1/health

HTTPS ব্যবহার করে একই {"healthy":true,"role":"active"} চালালে পুরো পথটি কাজ করছে কি না বোঝা যায়। Caddy থেকে পাওয়া 502 সাধারণত বোঝায় যে ntfy listen করছে না। sudo ss -lntp | grep 2586 দিয়ে পরীক্ষা করুন। ntfy listen করলে এবং 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 লিখলেই হয়। এভাবেই আপনার Jellyfin library-র জন্য 90s-এর video store front end Halcyon একই box-এর দ্বিতীয় subdomain-এ চালানো যায়।

আপনি যদি আগে থেকেই nginx চালান, ntfy-এর documentation-এ দেওয়া proxy settings কপি করুন: proxy_http_version 1.1, proxy_buffering off, proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for, এবং অন্তত তিন মিনিটের read ও send timeout রাখুন। কোনো subscriber listening অবস্থায় থাকলে একটি HTTP connection যতক্ষণ প্রয়োজন ততক্ষণ খোলা রাখে। nginx-এর default proxy_read_timeout 60 seconds-এর মানটি শুধু দুটি read-এর মধ্যবর্তী সময় গণনা করে। ntfy default হিসেবে প্রতি 45 seconds-এ একটি keepalive message পাঠায় (keepalive-interval)। এর উদ্দেশ্য হলো inactivity-এর কারণে intermediary যেন connection বন্ধ না করে। তাই quiet subscriber-ও stock nginx-এর পেছনে সংযুক্ত থাকে। দীর্ঘ timeout অতিরিক্ত সময়ের সুবিধা দেয়; connection সচল রাখার মূল কারণ এটি নয়। keepalive-interval বাড়ালে এর মান proxy-এর read timeout-এর নিচে রাখুন।

ব্যবহারকারী তৈরি করুন এবং topic-এর অ্যাক্সেস সীমাবদ্ধ করুন

Authentication সক্রিয় আছে, কিন্তু এখনো কারও কোনো কিছুর অ্যাক্সেস নেই। এটিই প্রত্যাশিত অবস্থা। নিজের জন্য একটি admin account এবং scripts-এর জন্য একটি machine account তৈরি করুন। এই command-গুলো 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। কোনো permission না দেওয়া পর্যন্ত তার কোনো access থাকে না।

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 access

একটি ACL (access control list) entry-তে user, topic এবং permission থাকে। Topic হয় একটি নির্দিষ্ট নাম, নয়তো এমন একটি pattern যেখানে * যেকোনো কিছুর সঙ্গে মেলে। তাই প্রতিটি host-এর জন্য আলাদা command না লিখে alerts_* দিয়ে alerts_backup এবং alerts_db কভার করা যায়। write permission-এর অর্থ শুধু publish করা। ফলে কোনো cron job থেকে token চুরি হলেও সেটি subscribe করে পাঠানো data পড়তে পারবে না। বিশেষ username everyone নির্ধারণ করে unauthenticated visitor কী করতে পারবে। deny-all default হিসেবে থাকলে এটি সাধারণত ইচ্ছাকৃতভাবে কোনো কিছু public করার জন্য ব্যবহার করবেন, যেমন ntfy access everyone status read। Anonymous visitor-দের কোনো topic থেকে দূরে রাখার জন্য স্পষ্ট rule লিখতেও deny গ্রহণ করা যায়।

Scripts-এ আপনার password নয়, একটি token রাখুন।

sudo docker compose exec ntfy ntfy token add robot

Command-টি tk_ দিয়ে শুরু হওয়া একটি token দেখায়। একটি token তার user-এর access হুবহু অনুসরণ করে। তাই এই token শুধু alerts topic-এ publish করতে পারে, অন্য কিছু করতে পারে না। কী কী আছে তা ntfy token list দেখায়। User-এর password পরিবর্তন না করে একটি token বাতিল করতে ntfy token remove ব্যবহার করুন।

আপনার প্রথম মেসেজ পাঠান এবং লকটি কাজ করছে কিনা তা যাচাই করুন

প্রথমে নিশ্চিত হয়ে নিন যে দরজাটি বন্ধ আছে।

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/alerts

সার্ভারটি JSON হিসেবে সংরক্ষিত মেসেজটি ফেরত পাঠাবে, যার মাধ্যমে আপনি নিশ্চিত হতে পারবেন যে মেসেজটি গৃহীত হয়েছে, হারিয়ে যায়নি। Title হলো বোল্ড করা প্রথম লাইন। Priority 1 থেকে 5 পর্যন্ত কাজ করে, অথবা min থেকে urgent পর্যন্ত নাম অনুযায়ী কাজ করে এবং এটি নির্ধারণ করে যে ফোনে শব্দ হবে কিনা। যখন নামটি কোনো পরিচিত ইমোজি শর্ট কোডের সাথে মিলে যায় তখন Tags নোটিফিকেশনে ইমোজিতে পরিণত হয়, আর না মিললে তা সাধারণ টেক্সট হিসেবেই থাকে।

টার্মিনাল থেকে কোনো টপিক পর্যবেক্ষণ করতে, সেটিকে স্ট্রিম করুন:

curl -s -u admin https://ntfy.example.com/alerts/raw

curl পাসওয়ার্ডের জন্য প্রম্পট করবে। প্রতিটি মেসেজ একটি লাইন হিসেবে আসবে এবং মাঝে মাঝে যে ফাঁকা লাইনগুলো দেখা যায় সেগুলো হলো কিপ-অ্যালাইভ (keepalives)। ব্রাউজারে https://ntfy.example.com ওপেন করে একই অ্যাকাউন্ট দিয়ে সাইন-ইন করলে আপনি একই স্ট্রিমের ওয়েব অ্যাপ সংস্করণটি ব্যবহার করতে পারবেন।

একটি script যাতে server-এ অতিরিক্ত request পাঠাতে না পারে, rate limit নির্ধারণ করুন

ডিফল্টভাবে প্রতিটি visitor 60টি request-এর একটি bucket পায়। প্রতি 5 সেকেন্ডে 1টি request হারে bucket-টি আবার পূরণ হয়। Private server-এর জন্য এটি যথেষ্ট বেশি। Retry loop-এ আটকে থাকা কোনো script পুরো bucket ব্যবহার করে ফেলতে পারে। server.yml-এ limit যোগ করুন।

visitor-request-limit-burst: 30
visitor-request-limit-replenish: "10s"
visitor-message-daily-limit: 500
sudo docker compose restart ntfy

Limit অতিক্রম করা visitor delivered message-এর বদলে HTTP 429 পায়। Limit visitor address অনুযায়ী গণনা করা হয়। তাই behind-proxy: true অত্যন্ত গুরুত্বপূর্ণ: এটি না থাকলে ntfy শুধু Caddy-এর address দেখতে পায়, ফলে প্রতিটি client একই visitor হিসেবে গণ্য হয়। একটি noisy script আপনার phone ও অন্য server-গুলোর সঙ্গে ভাগ করা bucket শেষ করে ফেলতে পারে। v2.36.0 থেকে daily count restart-এর পরেও user database-এ থাকে। প্রতিটি visitor-এর allowance midnight UTC-তে একসঙ্গে reset না হয়ে নিজস্ব 24-hour cycle অনুযায়ী reset হয়।

ব্যর্থ হওয়া cron job থেকে সতর্কতা

কমান্ড লাইনে টোকেন রাখা থেকে বিরত থাকুন। ps aux সার্ভারের প্রতিটি ব্যবহারকারীকে চলমান সব প্রসেসের পূর্ণাঙ্গ কমান্ড লাইন দেখায়, তাই -H দিয়ে পাঠানো টোকেন curl চলাকালীন যেকোনো লোকাল অ্যাকাউন্ট থেকে দেখা সম্ভব। একটি curl কনফিগারেশন ফাইল ব্যবহার করলে এই ঝুঁকি এড়ানো যায়।

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

এখন জবটিকে র‍্যাপ করুন। এটিকে /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

$? কমান্ডের ঠিক পরের লাইনেই ক্যাপচার করা হয়, কারণ পরবর্তী কোনো কমান্ড চললে তা আগের আউটপুট মুছে ফেলবে। আউটপুটটি tail -c 1000 এর মধ্য দিয়ে যায় কারণ ntfy বার্তার সর্বোচ্চ আকার সীমাবদ্ধ করে এবং একটি নোটিফিকেশন কোনো লগ ভিউয়ার নয়। শেষের exit "$code" মূল স্ট্যাটাস বজায় রাখে, যাতে এই জবটি পর্যবেক্ষণকারী অন্য কোনো প্রক্রিয়া ব্যর্থতা শনাক্ত করতে পারে। একবার পরীক্ষার জন্য স্ক্রিপ্টটিকে /bin/false এর দিকে নির্দেশ করে পুরো বিষয়টি যাচাই করুন।

একটি ব্যর্থতার শাখা যা কখনোই কার্যকর হয় না, তা কোনো সতর্কতা না থাকার চেয়েও খারাপ, কারণ এটি এমন ধারণা দেয় যে নীরবতা মানেই সাফল্য। Cron আপনার জবকে প্রায় খালি এনভায়রনমেন্ট এবং আপনার লগইন শেলের চেয়ে অনেক ছোট PATH প্রদান করে, তাই হাতে চালানো কোনো স্ক্রিপ্ট curl লাইন পর্যন্ত পৌঁছানোর আগেই বন্ধ হয়ে যেতে পারে। Cron job কেন চলে না তার নির্দেশিকা এই এনভায়রনমেন্ট সংক্রান্ত সমস্যাগুলো নিয়ে আলোচনা করে। সব জায়গায় অ্যাবসোলিউট পাথ ব্যবহার করুন এবং প্রথমবার শিডিউল অনুযায়ী চলার পর অনুমান না করে সরাসরি লগ ফাইলটি পড়ুন।

systemd unit ব্যর্থ হলে সতর্কতা পাঠান

Cron নির্ধারিত কাজের জন্য যথেষ্ট। দীর্ঘক্ষণ চলা service-এর জন্য OnFailure= প্রয়োজন, যা কোনো unit failed state-এ গেলে systemd চালায়। একটি 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-এ expand হয়। ফলে instantiated unit-এর নাম হয় ntfy-unit-failed@myapp.service.service। Template-এর ভেতরের %i script-এ myapp.service-কে প্রথম 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/false
sudo systemctl daemon-reload
sudo systemctl start ntfy-selftest.service

Start command non-zero exit status দিয়ে শেষ হবে এবং Job for ntfy-selftest.service failed because the control process exited with error code দেখাবে। প্রায় এক সেকেন্ড পরে ফোনে notification আসা উচিত। এরপর test unit-টি মুছে ফেলুন।

একটি গুরুত্বপূর্ণ সমস্যা মনে রাখুন। কোনো unit failed state-এ পৌঁছালেই শুধু OnFailure= চালানো হয়। কিন্তু automatic restart-এর সময় RestartMode=direct ওই state এড়িয়ে যায়। তাই failure handler-ও এড়িয়ে যায়। Default RestartMode=normal ব্যবহার করলে automatic restart-এর সময় failed state-এর মধ্য দিয়ে যায়। StartLimitBurst এবং StartLimitIntervalSec নির্ধারণ করে কখন repeated start প্রত্যাখ্যান করা হবে। এগুলো এমনভাবে সেট করুন, যাতে crash loop শেষ পর্যন্ত বন্ধ হয়। উপরের cron pattern-এর জন্য timer বেশি পরিষ্কার বিকল্প, কারণ timer-এর service unit একই OnFailure= drop-in সমর্থন করে। একটি service-কে timer-এ রূপান্তরের ধাপ VPS-এ systemd service ও timer-এর নির্দেশিকা-তে দেখানো হয়েছে।

একই 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 সেট করুন। একটি priority নির্বাচন করুন এবং robot access token পেস্ট করুন। সংরক্ষণ করার আগে test notification পাঠান, কারণ ভুল topic name হলে write grant-এ সেটি অন্তর্ভুক্ত না থাকায় error ফেরত আসে।

এই ব্যবস্থার সীমাবদ্ধতা স্পষ্ট: একই VPS-এ চলা monitor VPS-টি down হয়েছে কি না তা জানাতে পারে না, এবং ntfy নিজেই down থাকলে ntfy সেই খবর পাঠাতে পারে না। Monitor-টি অন্য একটি machine-এ চালান এবং এর জন্য email-এর মতো একটি দ্বিতীয় notification channel দিন, যাতে monitor নিজেই ntfy পর্যবেক্ষণ করতে পারে। Uptime Kuma-এর Push monitor type অন্য blind spot-টিও সমাধান করে: সফলভাবে run হওয়ার পর আপনার cron job একটি push URL call করে, এবং সেই call আসা বন্ধ হলে Kuma alert পাঠায়। Failure branch কেবল job run হওয়ার সময় কার্যকর হয়। তাই job কখনো start না হলে এটি কিছু জানাতে পারে না।

Self-hosted ntfy কি Android এবং iPhone-এ কাজ করে?

Android-এ কোনো শর্ত ছাড়াই কাজ করে। Google Play বা F-Droid থেকে অ্যাপটি ইনস্টল করুন, Settings খুলে default server হিসেবে https://ntfy.example.com সেট করুন, user management screen-এ আপনার account যোগ করুন, তারপর alerts-এ subscribe করুন। Instant delivery চালু থাকলে একটি foreground service চলতে থাকে। তাই ফোন doze mode-এ থাকলেও message পৌঁছে যায়। এর সঙ্গে থাকা স্থায়ী notification Android-এর foreground service-এর জন্য বাধ্যতামূলক। এটি কোনো bug নয়। F-Droid build-এ কোনো Firebase code নেই। তাই প্রতিটি subscription instant delivery ব্যবহার করে। ntfy UnifiedPush distributor হিসেবেও কাজ করতে পারে। এটি Google-এর push service-এর একটি open replacement। তাই UnifiedPush সমর্থনকারী অন্যান্য app-ও আপনার server-এর মাধ্যমে message deliver করতে পারে।

Official iOS app-এ এটি কাজ করে, তবে একটি dependency আছে যা আপনি সরাতে পারবেন না। iOS backgrounded app স্থগিত করে। Apple যে background mode-গুলো অনুমোদন করে, যেমন audio চালানো, location update গ্রহণ করা এবং scheduled task process করা, সেগুলো কোনো app-কে আপনার server থেকে message-এর অপেক্ষায় বসে থাকতে দেয় না। তাই দ্রুত app জাগাতে APNs (Apple push notification service) ব্যবহার করতে হয়। শুধু app-এর জন্য অনুমোদিত credentials থাকা provider-ই app-এ notification পাঠাতে পারে। তাই আপনার server সরাসরি official app-এ পৌঁছাতে পারে না। ntfy এটি একটি relay-এর মাধ্যমে সমাধান করে। আপনার server message ID ধারণকারী একটি poll_request ntfy.sh-এ পাঠায়। ntfy.sh সেটি Firebase এবং APNs-এর মাধ্যমে পাঠিয়ে app-টিকে জাগায়। এরপর app আপনার server থেকে message body সংগ্রহ করে।

upstream-base-url: "https://ntfy.sh"

এই ব্যবস্থার খরচ ও সীমাবদ্ধতা স্পষ্টভাবে বুঝুন। Message content আপনার নিজের server-এই থাকে। তবে message এসেছে—এই তথ্য এবং তার ID আপনার পরিচালিত নয় এমন infrastructure-এর মধ্য দিয়ে যায়। এই setting ছাড়া self-hosted server থেকে iPhone-এ notification শেষ পর্যন্ত পৌঁছায়। তবে ntfy-এর documentation অনুযায়ী এতে কয়েক ঘণ্টা পর্যন্ত দেরি হতে পারে, কারণ app-টিকে দ্রুত জাগানোর কোনো ব্যবস্থা থাকে না। ntfy.sh relay ছাড়া native iOS app ব্যবহার করতে হলে নিজের Apple developer account এবং নিজের APNs key দিয়ে app-টি নিজেকেই build ও ship করতে হবে। এর জন্য বার্ষিক fee দিতে হবে এবং প্রতিটি update-এর জন্য app আবার build করতে হবে। আরেকটি উপায় হলো iOS 16.4 বা পরবর্তী সংস্করণে ntfy-এর PWA ব্যবহার করা। এটি home screen-এ যোগ করুন এবং আপনার server-এ Web Push configure করুন। এতে ntfy.sh relay এড়ানো যায়। তবে browser-এর push infrastructure তখনও ব্যবহৃত হয়। আপনার ব্যবহারের ক্ষেত্রে relay গ্রহণযোগ্য না হলে alerting Android অথবা desktop web app-এ সীমাবদ্ধ রাখুন।

Backup, upgrade এবং image pin করা

দুটি path পুনরায় তৈরি করা যায় না: /etc/ntfy/server.yml এবং /var/lib/ntfy/user.db। দ্বিতীয়টিতে প্রতিটি 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-টি server-এর বাইরে copy করুন। cache.db-এ সাম্প্রতিক message থাকে। উপরের cache-duration অনুযায়ী এতে 12 ঘণ্টার message থাকে। পরে delivery-র জন্য schedule করা message-ও এতে থাকে, যা delivery হওয়ার 12 ঘণ্টা পর পর্যন্ত সংরক্ষিত থাকে। আগে থেকে message schedule না করলে এটি হারালেও সুরক্ষার মতো গুরুত্বপূর্ণ কিছু হারাবে না। 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 পড়ুন। Start হওয়ার সময় SQLite database migrate হয়। তাই schema পরিবর্তনের পরে পুরোনো tag-এ rollback করা নিরাপদ নয়। উদাহরণস্বরূপ, v2.31.1 message cache-কে schema version 17-এ সরিয়েছে। এর upgrade notes-এ বলা আছে, v2.31.0 বা তার আগের version-এ downgrade করতে হলে version-টি হাতে করে 16-এ ফিরিয়ে দিতে হবে। v2.36.0-এ upgrade করলে সবার বিদ্যমান daily count একবার reset হয়। নতুন version এক দিন চলা পর্যন্ত সদ্য নেওয়া backup রেখে দিন। Notes-এ behaviour change-ও উল্লেখ থাকে। v2.31.0 থেকে since=<message ID> নিয়ে reconnect করা client একই second-এ publish হওয়া message-ও পায়। ফলে duplicate দেখা যেতে পারে। ntfy app এবং web app message ID অনুযায়ী duplicate বাদ দেয়। তবে নিজের লেখা কোনো script যদি topic replay করে, তাকেও একই কাজ করতে হবে। Server-এর প্রতিটি service-এর এমন কিছু path-এর সংক্ষিপ্ত তালিকা থাকে, যেগুলো পুনরায় তৈরি করা যায় না। একই ধরনের VPS-এ photo library-এর জন্য PhotoPrism এবং Immich-এর তুলনা সেই তালিকা এবং সংশ্লিষ্ট backup command নির্ধারণ করে।

Gotify ও Apprise

Gotify তুলনামূলকভাবে ছোট সমাধান: একটি binary-এর সঙ্গে web UI এবং Android app থাকে। বার্তাগুলো application অনুযায়ী সাজানো হয়। তাই Android-ই একমাত্র target হলে private box-এর জন্য এটি উপযোগী।

Apprise হলো একটি Python library এবং command line tool। আলাদা Apprise API server-ও পাওয়া যায়। এটি একটি বার্তা ntfy-সহ শতাধিক service-এ পাঠাতে পারে। তাই একই সময়ে একাধিক জায়গায় বার্তা পাঠাতে হবে এমন script-এর জন্য এটি উপযোগী।

ntfy server, HTTP API এবং উভয় mobile platform-এর জন্য app দেয়। এই কারণে rented server থেকে alert পাঠানোর ক্ষেত্রে এটিই সাধারণত ব্যবহৃত হয়।

FAQ

আমার ntfy server-এ publish করলে 403 কেন ফেরত আসে?

auth-default-access: "deny-all"-এ server.yml ব্যবহার করলে anonymous publish প্রত্যাখ্যান করা হয়। এটিই নির্ধারিত আচরণ। -u user:pass অথবা -H "Authorization: Bearer tk_..." দিয়ে credentials পাঠান। আপনি ইতিমধ্যে token পাঠালেও যদি 403 পান, তাহলে পরীক্ষা করুন সংশ্লিষ্ট user-এর ACL entry-তে topic-এ লেখার অনুমতি আছে কি না। কোনো matching entry না থাকলে, read-only অথবা deny publish প্রত্যাখ্যান করে। v2.34.0-এ একই IP থেকে আসা concurrent request-এর কারণে বৈধ credentials-ও anonymous হিসেবে বিবেচিত হতে পারত। v2.35.0-এ এই bug ঠিক করা হয়েছে। তাই intermittent 403-কে ACL সমস্যার প্রমাণ ধরে নেওয়ার আগে upgrade করুন। সম্পূর্ণ তালিকা দেখতে ntfy access চালান। মনে রাখবেন, write grant দিয়ে subscribe করা যায় না। তাই যে account সফলভাবে publish করতে পারে, একই topic পড়ার চেষ্টা করলে সেটিও প্রত্যাখ্যাত হবে।

self-hosted ntfy server-এ iPhone-এ notification কাজ করে কি?

Official iOS app ব্যবহার করলে relay-এর মাধ্যমে এগুলো কাজ করে। suspended iPhone app-কে দ্রুত wake করার notification অবশ্যই APNs (Apple push notification service)-এর মাধ্যমে আসতে হয়। Official app-এ পাঠাতে হলে তার publisher-এর push credentials প্রয়োজন। তাই ntfy message ID-সহ একটি poll_request ntfy.sh-এ পাঠায়, এবং ntfy.sh সেটি device-এ relay করে। server.yml-এ upstream-base-url: "https://ntfy.sh" সেট করুন এবং container restart করুন। Message body নিজেই আপনার server থেকে fetch করা হয়। এই setting না থাকলেও iOS notification শেষ পর্যন্ত পৌঁছায়, তবে ntfy-এর documentation অনুযায়ী delay কয়েক ঘণ্টা পর্যন্ত হতে পারে। আপনার server-এ Web Push configure করা থাকলে iOS 16.4 বা পরবর্তী সংস্করণে PWA আরেকটি উপায় দেয়।

আমার cron job-এর ntfy alert কখনো পৌঁছায়নি কেন?

প্রথমে curl line-টি আলাদাভাবে চালিয়ে token এবং topic সঠিক কি না নিশ্চিত করুন। হাতে চালালে কাজ করে কিন্তু cron থেকে কাজ না করলে, alert-এর আগের ধাপে failure হচ্ছে। cron job চালানোর সময় minimal environment এবং ছোট PATH ব্যবহার করে। তাই bare name দিয়ে কোনো command call করা script curl line-এ পৌঁছানোর আগেই বন্ধ হয়ে যেতে পারে। Absolute path ব্যবহার করুন, job-এর output একটি log file-এ redirect করুন, এবং পরবর্তী run-এর পরে সেই file পড়ুন। Delivery-এর বদলে 429 response পাওয়া গেলে কোনো limit request-টি প্রত্যাখ্যান করেছে। সাধারণত script খুব দ্রুত retry করছে। তবে যে visitor দৈনিক quota শেষ করে ফেলেছে, যেমন উপরে নির্ধারিত message limit, একটিমাত্র request করলেও একইভাবে প্রত্যাখ্যাত হবে।

ntfy কি public internet-এ expose করা উচিত?

Phone app-গুলোকে mobile network থেকে server-এ পৌঁছাতে হয়। তাই auth-default-access: "deny-all" এবং per-topic ACL-সহ একটি public HTTPS endpoint সাধারণ setup। কোনো topic everyone দ্বারা readable না হলে এটি নিরাপদ। যখন প্রতিটি subscriber আপনার নিয়ন্ত্রণাধীন machine, তখন VPN-only instance যুক্তিসঙ্গত। Phone-এর ক্ষেত্রে এটি উপযুক্ত নয়। কারণ tunnel চালু থাকা অবস্থাতেই app notification পায়। তাই phone পুনরায় connect না করা পর্যন্ত alert queue-তে জমা থাকে।

এই লেখাটি কি কাজে লেগেছে?