Cara Self-Host ntfy untuk Notifikasi Server
Jalankan ntfy di VPS dengan Docker Compose dan TLS. Lindungi topic memakai pengguna serta ACL, lalu kirim peringatan dari cron dan unit systemd OnFailure.
Yang dilakukan server ntfy yang di-host sendiri
Server ntfy yang di-host sendiri mengubah HTTP POST menjadi notifikasi push di ponsel Anda. Anda menerbitkan pesan menggunakan curl, lalu pesan tersebut tiba di aplikasi Android, aplikasi iOS, tab browser, atau perangkat lain yang dapat mempertahankan koneksi HTTP tetap terbuka. Anda tidak perlu memasang pustaka klien atau menjalankan message broker.
ntfy mengalamatkan pesan berdasarkan topic. Topic adalah nama pada path URL, seperti https://ntfy.example.com/alerts, dan langsung tersedia saat seseorang menerbitkan pesan ke topic tersebut. Pada instalasi default, siapa pun yang mengetahui nama itu dapat membaca dan menulis ke topic, sehingga dokumentasi proyek ini sendiri membandingkan nama topic dengan password. Model ini sesuai untuk layanan ntfy.sh publik. Namun, model ini tidak sesuai untuk server yang membawa notifikasi kegagalan backup Anda. Karena itu, panduan ini mengaktifkan autentikasi sebelum pesan pertama dikirim.
Yang Anda perlukan sebelum memulai
Anda memerlukan VPS yang menjalankan Ubuntu 24.04 atau Debian 13 dengan Docker Engine dan plugin Compose, nama domain, serta RAM yang sangat terbatas. Buat DNS (domain name system) A record yang mengarahkan ntfy.example.com ke alamat IP publik server, lalu pastikan record tersebut dapat di-resolve sebelum melakukan langkah lain.
dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw statusdig harus menampilkan IP server Anda. Penerbitan sertifikat memerlukan hostname yang dapat di-resolve secara publik ke server melalui record A atau AAAA. Port 80 tetap terbuka karena ACME (automatic certificate management environment), protokol yang digunakan Let's Encrypt, memakainya untuk HTTP challenge. Container ntfy sendiri tidak pernah membuka port publik.
Tulis file konfigurasi ntfy
Docker image tidak menyertakan file konfigurasi, jadi Anda harus membuatnya. Setiap perintah di bagian berikutnya membaca file ini. Pertama, cari user ID dan group ID yang akan digunakan 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: falseEmpat baris tersebut memiliki peran utama. base-url harus berupa alamat HTTPS publik yang tepat, karena ntfy menggunakannya untuk membuat link lampiran dan notifikasi push iOS yang di-host sendiri. listen-http: ":2586" mengikat layanan ke semua interface di dalam container. Hal ini tampak kurang ketat, tetapi memang benar: container memiliki network namespace sendiri, sehingga jika layanan diikat ke 127.0.0.1, port tersebut tidak dapat dijangkau dari host dan port yang dipublikasikan Docker tidak akan pernah terhubung. auth-default-access: "deny-all" merupakan keseluruhan konfigurasi keamanannya, karena menolak akses baca dan tulis bagi siapa pun yang tidak memiliki izin eksplisit. behind-proxy: true memberi tahu ntfy untuk mengambil alamat client dari header X-Forwarded-For, sehingga rate limit menghitung pengunjung sebenarnya, bukan reverse proxy sebagai satu client yang sangat sibuk.
enable-login: true memungkinkan user login melalui aplikasi web atau API. enable-signup tetap bernilai false karena pembuatan akun mandiri pada server privat membuka akses tanpa memberikan manfaat tambahan.
sudo chown "$(id -u):$(id -g)" /etc/ntfy/server.yml
sudo chmod 600 /etc/ntfy/server.ymlJalankan ntfy dengan Docker Compose
Masukkan ini ke dalam /opt/ntfy/compose.yaml, dengan mengganti 1000:1000 menggunakan dua angka id -u dan id -g yang tercetak di atas.
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/healthServer yang sehat merespons {"healthy":true,"role":"active"}. Dua detail dalam file Compose tersebut memang disengaja. Image dikunci ke v2.36.0, yaitu rilis stabil saat ini per 1 November 2026, bukan latest, karena dengan latest, docker compose pull berikutnya mengunduh image saat ini, lalu docker compose up -d berikutnya membuat ulang container dengan image tersebut; hanya melakukan pull tidak mengubah versi server yang sedang berjalan. Pin tetap perlu diperbarui. Pada Oktober 2026 saja terdapat sepuluh rilis: v2.29.0 pada 7 Oktober, v2.30.0 pada 12 Oktober, v2.31.0 dan v2.31.1 pada 16 Oktober, v2.32.0 pada 18 Oktober, v2.33.0 dan v2.33.1 pada 23 Oktober, v2.34.0 pada 24 Oktober, v2.35.0 pada 30 Oktober, dan v2.36.0 pada 31 Oktober. v2.31.0 memperbaiki pesan yang hilang ketika client tersambung kembali sebelum pesan tersebut masuk ke cache pesan, tetapi proses penyambungan kembali dengan since=<message ID> membaca setiap pesan dalam topic dari database, sehingga ntfy.sh melakukan rollback dari versi tersebut. v2.31.1 memperbaiki beban tersebut dengan index baru, sedangkan v2.34.0 memperbaiki masalah pengguna yang aksesnya dicabut atau dihapus tetap memiliki beberapa subscription. v2.35.0 memperbaiki permintaan bersamaan yang memperlakukan kredensial valid sebagai anonim serta bypass otorisasi Matrix push gateway pada SQLite, jadi pindahkan pin yang lebih lama ke v2.36.0. Port dipublikasikan sebagai 127.0.0.1:2586:2586, sehingga container hanya dapat dijangkau dari alamat loopback host. Jika Anda menulis 2586:2586, Docker memasukkan aturan firewall-nya sendiri sebelum aturan Anda. Akibatnya, port tersebut merespons dari Internet meskipun ufw status menyatakan bahwa port tertutup. Kedua kebiasaan ini juga berlaku untuk container berikutnya yang Anda tambahkan: relay RustDesk yang di-host sendiri mengunci tag image dengan cara yang sama, tetapi relay tersebut tidak dapat disembunyikan di balik loopback karena port signal dan relay-nya harus merespons dari Internet.
Jika curl mencetak Connection refused, baca log container. Error izin pada /var/lib/ntfy/user.db berarti baris user: tidak cocok dengan pemilik direktori tersebut, sehingga proses tidak dapat membuat database sendiri dan berhenti. Panduan dasar Docker Compose untuk VPS membahas kepemilikan volume dan kebijakan restart secara lebih rinci.
Pasang TLS di depan dengan Caddy
Caddy meminta dan memperbarui sertifikat secara mandiri. Ini adalah cara tercepat untuk mengaktifkan TLS (keamanan lapisan transport).
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 caddyGanti isi /etc/caddy/Caddyfile dengan tiga baris.
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"} yang sama melalui HTTPS menunjukkan bahwa seluruh jalur berfungsi. 502 dari Caddy biasanya berarti ntfy tidak sedang listening. Periksa dengan sudo ss -lntp | grep 2586. Jika ntfy sedang listening dan 502 tetap muncul, log Caddy mencatat error upstream yang ditemuinya, seperti koneksi yang di-reset. Error sertifikat biasanya berarti record DNS salah atau validasi sertifikat tidak dapat menjangkau server pada port 80 atau 443. Periksa sudo journalctl -u caddy -n 50 untuk melihat error validasi. Jika nanti menambahkan service lain, Anda hanya perlu menambahkan satu blok hostname lagi dalam Caddyfile yang sama. Dengan cara ini, sesuatu seperti Halcyon, frontend toko video era 90-an untuk library Jellyfin Anda dapat ditempatkan pada subdomain kedua di server yang sama.
Jika Anda sudah menjalankan nginx, salin pengaturan proxy yang didokumentasikan ntfy: proxy_http_version 1.1, proxy_buffering off, proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for, serta timeout baca dan kirim minimal tiga menit. Subscriber mempertahankan satu koneksi HTTP tetap terbuka selama proses listening. Nilai default nginx, proxy_read_timeout sebesar 60 detik, hanya menghitung waktu di antara dua operasi baca. Secara default, ntfy mengirim pesan keepalive setiap 45 detik (keepalive-interval) agar perantara tidak menutup koneksi karena tidak ada aktivitas. Karena itu, subscriber yang tidak menerima pesan tetap terhubung meskipun berada di belakang nginx dengan konfigurasi standar. Timeout yang lebih panjang hanya menyediakan ruang tambahan, bukan faktor yang membuat koneksi tetap hidup. Jika Anda menaikkan keepalive-interval, pertahankan nilainya di bawah read timeout proxy Anda.
Buat pengguna dan batasi topik
Autentikasi sudah aktif, dan belum ada yang dapat mengakses apa pun. Memang demikian seharusnya. Buat satu akun admin untuk Anda sendiri dan satu akun mesin untuk skrip. Perintah ini membaca /etc/ntfy/server.yml dari dalam container. Karena itu, file konfigurasi dipasang sebagai volume.
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 listSetiap perintah user add meminta password. Admin mengabaikan daftar kontrol akses dan dapat membaca serta menulis semua topik. Karena itu, gunakan akun tersebut untuk Anda sendiri dan aplikasi ponsel. robot adalah pengguna biasa tanpa akses apa pun sampai Anda memberikan akses.
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 accessEntri ACL (access control list) terdiri atas pengguna, topik, dan izin. Topik dapat berupa nama literal atau pola. Dalam pola tersebut, * cocok dengan apa pun. Dengan demikian, alerts_* mencakup alerts_backup dan alerts_db tanpa memerlukan satu perintah untuk setiap host. Izin write berarti hanya dapat melakukan publish. Dengan begitu, token yang dicuri dari cron job tidak dapat melakukan subscribe dan membaca kembali data yang dikirimnya. Nama pengguna khusus everyone menentukan tindakan yang boleh dilakukan pengunjung tanpa autentikasi. Dengan deny-all sebagai default, Anda terutama akan menggunakannya untuk membuka sesuatu secara sengaja agar dapat diakses publik, seperti ntfy access everyone status read. Nilai tersebut juga menerima deny jika Anda ingin membuat aturan eksplisit yang tetap melarang pengunjung anonim mengakses suatu topik.
Skrip harus menggunakan token, bukan password Anda.
sudo docker compose exec ntfy ntfy token add robotPerintah tersebut mencetak token yang diawali dengan tk_. Token mewarisi akses pengguna yang terkait dengannya secara persis. Jadi, token ini dapat melakukan publish ke topik alerts dan tidak dapat melakukan tindakan lain. ntfy token list menampilkan token yang ada, sedangkan ntfy token remove mencabut satu token tanpa mengubah password pengguna.
Kirim pesan pertama Anda dan buktikan bahwa penguncian berfungsi
Mulai dengan memeriksa bahwa pintu sudah tertutup.
curl -s -o /dev/null -w '%{http_code}\n' -d "hello" https://ntfy.example.com/alertsPerintah tersebut menampilkan 403, dan 403 adalah jawaban yang benar: auth-default-access: "deny-all" menolak publikasi anonim. Sekarang kirim pesan yang sebenarnya.
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 membalas dengan pesan yang tersimpan dalam format JSON. Ini menunjukkan bahwa pesan diterima, bukan diabaikan. Title adalah baris pertama yang dicetak tebal. Priority menggunakan nilai dari 1 hingga 5, atau nama dari min hingga urgent, dan menentukan apakah ponsel mengeluarkan bunyi. Tags menjadi emoji pada notifikasi jika namanya cocok dengan kode singkat emoji yang dikenal, dan tetap sebagai teks biasa jika tidak cocok.
Untuk memantau topik dari terminal, lakukan streaming:
curl -s -u admin https://ntfy.example.com/alerts/rawcurl akan meminta kata sandi. Setiap pesan muncul sebagai satu baris, dan baris kosong yang sesekali muncul adalah keepalive. Membuka https://ntfy.example.com di browser dan masuk dengan akun yang sama akan menampilkan versi web dari streaming yang sama.
Atur batas laju agar satu skrip tidak membanjiri server
Secara default, setiap pengunjung mendapatkan bucket berisi 60 request, yang diisi ulang dengan laju satu request setiap 5 detik. Batas ini cukup longgar untuk server pribadi, dan skrip yang terjebak dalam loop percobaan ulang akan menghabiskannya. Tambahkan batas ke server.yml.
visitor-request-limit-burst: 30
visitor-request-limit-replenish: "10s"
visitor-message-daily-limit: 500sudo docker compose restart ntfyPengunjung yang melampaui batas akan menerima HTTP 429, bukan pesan yang dikirimkan. Batas ini dihitung berdasarkan alamat pengunjung. Karena itu, behind-proxy: true sangat penting: tanpa pengaturan tersebut, ntfy hanya melihat alamat Caddy, sehingga setiap client dihitung sebagai pengunjung yang sama. Akibatnya, satu skrip yang menghasilkan banyak request dapat menghabiskan bucket yang digunakan bersama oleh ponsel Anda dan server lain. Mulai v2.36.0, jumlah harian tetap tersimpan di database pengguna setelah restart, dan jatah setiap pengunjung direset berdasarkan siklus 24 jamnya sendiri, bukan pada tengah malam UTC.
Peringatan dari cron job yang gagal
Jangan menaruh token pada command line. ps aux menampilkan command line lengkap dari setiap proses yang sedang berjalan kepada semua user di server, sehingga token yang diteruskan dengan -H dapat dibaca oleh akun lokal mana pun selama curl berjalan. File konfigurasi curl menghindari masalah ini.
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/curlrcBerikutnya, bungkus job tersebut. Simpan ini sebagai /usr/local/bin/backup-with-alert.sh, lalu 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$? ditangkap pada baris tepat setelah command tersebut karena command berikutnya akan menimpanya. Output diteruskan melalui tail -c 1000 karena ntfy memberlakukan ukuran pesan maksimum dan notifikasi bukanlah log viewer. exit "$code" penutup mempertahankan status awal, sehingga apa pun yang juga memantau job ini tetap melihat kegagalan. Uji seluruh proses dengan mengarahkan script ke /bin/false untuk satu kali eksekusi.
Branch kegagalan yang tidak pernah dijalankan lebih buruk daripada tidak memiliki sistem peringatan karena kondisi tersebut membuat keheningan terlihat seperti keberhasilan. Cron memberikan environment yang hampir kosong kepada job Anda dan PATH yang jauh lebih pendek daripada shell login. Akibatnya, script yang berjalan saat dijalankan secara manual dapat berhenti sebelum mencapai baris curl. Panduan tentang penyebab cron job tidak berjalan membahas masalah environment tersebut. Gunakan path absolut di semua tempat, lalu baca file log setelah eksekusi terjadwal pertama, bukan langsung menganggap job berhasil.
Berikan peringatan saat unit systemd gagal
Cron menangani pekerjaan terjadwal. Service yang berjalan lama memerlukan OnFailure=, yang dijalankan systemd setiap kali unit memasuki status failed. Buat satu unit template dan gunakan kembali unit tersebut untuk setiap service pada server. Simpan sebagai /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 %iKemudian /usr/local/bin/ntfy-unit-failed, dengan 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/alertsHubungkan unit tersebut ke service menggunakan drop-in agar pembaruan paket tidak menimpa perubahan Anda.
sudo systemctl edit myapp.service[Unit]
OnFailure=ntfy-unit-failed@%n.service%n diperluas menjadi nama unit lengkap, sehingga unit yang dibuat menjadi ntfy-unit-failed@myapp.service.service, sedangkan %i di dalam template meneruskan myapp.service ke script sebagai argumen pertamanya. Dengan demikian, satu template dapat digunakan untuk setiap unit. Buktikan bahwa konfigurasi ini berfungsi dengan unit yang sengaja dibuat gagal, lalu simpan sebagai /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.servicePerintah start keluar dengan kode non-zero dan menampilkan Job for ntfy-selftest.service failed because the control process exited with error code, lalu ponsel akan bergetar sekitar satu detik kemudian. Hapus unit pengujian setelah selesai.
Ada satu jebakan yang perlu diperhatikan. OnFailure= hanya dijalankan ketika unit mencapai status failed, sedangkan RestartMode=direct melewati status tersebut selama restart otomatis sehingga handler kegagalan juga dilewati. Dengan RestartMode=normal default, restart otomatis melewati status failed. StartLimitBurst dan StartLimitIntervalSec mengatur kapan percobaan start berulang ditolak; atur keduanya agar crash loop akhirnya berhenti. Timer merupakan pengganti yang lebih tepat untuk pola cron di atas karena service unit milik timer mendukung drop-in OnFailure= yang sama, dan panduan tentang service dan timer systemd pada VPS menjelaskan langkah untuk mengonversi salah satunya.
Hubungkan monitor uptime ke topik yang sama
Uptime Kuma, monitor status yang di-host sendiri, menyediakan jenis notifikasi ntfy. Buka Settings, lalu Notifications, kemudian Setup Notification, pilih Ntfy, tetapkan URL server ke https://ntfy.example.com dan topik ke alerts, pilih prioritas, lalu tempel access token robot. Kirim notifikasi pengujian sebelum menyimpan, karena nama topik yang salah akan menghasilkan error pada pemberian write yang tidak mencakup topik tersebut.
Batasan pengaturan ini perlu dipahami: monitor yang berjalan pada VPS yang sama tidak dapat memberi tahu Anda bahwa VPS tersebut sedang down, dan ntfy tidak dapat mengirimkan informasi bahwa ntfy sedang down. Jalankan monitor pada mesin yang berbeda, lalu berikan kanal notifikasi kedua, seperti email, untuk monitor yang memantau ntfy itu sendiri. Jenis monitor Push pada Uptime Kuma mengatasi titik buta lainnya: cron job Anda memanggil URL push setelah berhasil dijalankan, dan Kuma mengirimkan alert ketika panggilan tersebut berhenti diterima. Cabang kegagalan hanya aktif ketika job berjalan, sehingga tidak memberikan informasi apa pun jika job tidak pernah dimulai.
Apakah ntfy dapat digunakan pada Android dan iPhone dengan server yang di-host sendiri?
Pada Android, ya, tanpa pengecualian. Instal aplikasi dari Google Play atau F-Droid, buka Settings, tetapkan server default ke https://ntfy.example.com, tambahkan akun Anda pada layar user management, lalu subscribe ke alerts. Pengiriman instan mempertahankan foreground service agar pesan tetap diterima meskipun ponsel berada dalam mode doze. Notifikasi permanen yang menyertainya merupakan persyaratan Android untuk foreground service, bukan bug. Build F-Droid sama sekali tidak memuat kode Firebase, sehingga setiap subscription menggunakan pengiriman instan. ntfy juga dapat berfungsi sebagai distributor UnifiedPush, yaitu pengganti terbuka untuk layanan push Google. Dengan demikian, aplikasi lain yang mendukung UnifiedPush juga dapat mengirim notifikasi melalui server Anda.
Pada aplikasi iOS resmi, ntfy dapat digunakan dengan satu dependensi yang tidak dapat dihapus. iOS menangguhkan aplikasi yang berjalan di latar belakang. Mode latar belakang yang diizinkan Apple—memutar audio, menerima pembaruan lokasi, dan memproses tugas terjadwal—tidak memungkinkan aplikasi menunggu pesan dari server Anda. Karena itu, pengaktifan aplikasi secara cepat harus dilakukan melalui APNs (Apple push notification service). Hanya provider dengan kredensial yang diotorisasi untuk aplikasi tersebut yang dapat mengirim notifikasi. Server Anda tidak dapat menghubungi aplikasi resmi secara langsung. ntfy mengatasi hal ini dengan relay: server Anda mengirim poll_request yang berisi ID pesan ke ntfy.sh. ntfy.sh meneruskannya melalui Firebase dan APNs untuk mengaktifkan aplikasi. Setelah itu, aplikasi mengambil isi pesan dari server Anda.
upstream-base-url: "https://ntfy.sh"Pahami konsekuensinya. Isi pesan tetap berada di server Anda, tetapi informasi bahwa pesan telah tiba dan ID pesan tersebut melewati infrastruktur yang tidak Anda kelola. Tanpa pengaturan ini, notifikasi pada iPhone dari server yang di-host sendiri tetap dapat tiba, tetapi dokumentasi ntfy memperingatkan bahwa penundaannya dapat mencapai beberapa jam karena tidak ada mekanisme yang segera mengaktifkan aplikasi. Untuk menggunakan aplikasi iOS native tanpa relay ntfy.sh, build dan distribusikan aplikasi sendiri menggunakan akun Apple developer dan kunci APNs milik Anda. Cara ini memerlukan biaya tahunan dan build ulang untuk setiap pembaruan. Pilihan lain adalah PWA ntfy pada iOS 16.4 atau yang lebih baru. Tambahkan PWA tersebut ke layar utama dan konfigurasi Web Push pada server Anda. Cara ini menghindari relay ntfy.sh, tetapi tetap menggunakan infrastruktur push milik browser. Jika relay tidak dapat diterima untuk kebutuhan Anda, gunakan Android atau aplikasi web desktop untuk menerima notifikasi.
Pencadangan, upgrade, dan menetapkan image
Dua path tidak dapat dibuat ulang: /etc/ntfy/server.yml dan /var/lib/ntfy/user.db. Path kedua menyimpan setiap pengguna, hash password, entri ACL, dan token, jadi perlakukan seperti cryptographic key privat.
sudo tar czf ntfy-backup.tgz -C / etc/ntfy var/lib/ntfy
sudo chmod 600 ntfy-backup.tgzSalin file tersebut ke luar server. cache.db menyimpan pesan terbaru, yaitu pesan selama 12 jam yang terkait dengan cache-duration di atas, serta pesan apa pun yang dijadwalkan untuk dikirim kemudian. Pesan tersebut tetap disimpan hingga 12 jam setelah dikirim. Jika Anda tidak menjadwalkan pesan sebelumnya, kehilangan file ini tidak menyebabkan kehilangan data yang perlu dilindungi. Upgrade dilakukan dengan mengedit tag dalam file compose, melakukan pull image, lalu membuat ulang container.
sudo docker compose pull
sudo docker compose up -d
curl -s https://ntfy.example.com/v1/healthBaca catatan rilis terlebih dahulu. Database SQLite dimigrasikan saat start, sehingga melakukan rollback ke tag yang lebih lama setelah perubahan schema tidak aman. Misalnya, v2.31.1 memindahkan cache pesan ke schema version 17. Catatan upgrade-nya menyatakan bahwa downgrade ke v2.31.0 atau versi sebelumnya memerlukan pengembalian version tersebut secara manual ke 16. Upgrade ke v2.36.0 akan mengatur ulang jumlah harian yang sudah ada untuk semua pengguna satu kali. Simpan backup yang baru saja dibuat hingga versi baru berjalan selama satu hari. Catatan tersebut juga menandai perubahan perilaku. Mulai v2.31.0, client yang melakukan reconnect dengan since=<message ID> juga menerima pesan yang dipublikasikan pada detik yang sama, sehingga dapat melihat duplikat. Aplikasi ntfy dan aplikasi web menghapus duplikat berdasarkan message ID, tetapi script buatan Anda yang memutar ulang topic harus melakukan hal yang sama. Setiap service pada server memiliki daftar singkat path yang tidak dapat dibuat ulang. Perbandingan PhotoPrism dan Immich menyusun daftar tersebut beserta perintah backup yang sesuai untuk pustaka foto pada jenis VPS yang sama.
Gotify dan Apprise
Gotify adalah opsi yang lebih sederhana: satu binary dengan web UI dan aplikasi Android, dengan pesan yang dikelompokkan berdasarkan aplikasi. Ini cocok untuk server pribadi yang hanya menargetkan Android. Apprise adalah library Python dan alat command line, serta menyediakan server Apprise API terpisah. Apprise dapat meneruskan satu pesan ke lebih dari seratus service, termasuk ntfy. Ini cocok untuk script yang harus mengirim pesan ke beberapa tujuan sekaligus. ntfy menyediakan server, HTTP API, serta aplikasi untuk kedua platform seluler. Karena itu, ntfy biasanya dipilih untuk mengirimkan alert dari server sewaan.
FAQ
Mengapa publikasi ke server ntfy saya menghasilkan 403?
Dengan auth-default-access: "deny-all" di server.yml, publikasi anonim ditolak. Perilaku ini memang disengaja. Kirim kredensial dengan -u user:pass atau -H "Authorization: Bearer tk_...". Jika Anda sudah mengirim token tetapi masih menerima 403, periksa apakah pengguna tersebut memiliki entri ACL yang mengizinkan penulisan ke topik: tanpa entri yang cocok, read-only atau deny akan menolak publikasi. Pada v2.34.0, permintaan serentak dari IP yang sama juga dapat membuat kredensial yang valid dianggap anonim. v2.35.0 memperbaiki bug tersebut, jadi lakukan upgrade sebelum menganggap 403 yang terjadi sesekali sebagai bukti masalah ACL. Jalankan ntfy access untuk mencetak seluruh daftar. Perhatikan bahwa grant write tidak mengizinkan subscribe. Jadi, akun yang berhasil melakukan publikasi tetap akan ditolak saat mencoba membaca topik yang sama.
Apakah notifikasi berfungsi di iPhone dengan server ntfy yang di-host sendiri?
Notifikasi berfungsi melalui relay jika Anda menggunakan aplikasi iOS resmi. Untuk membangunkan aplikasi iPhone yang ditangguhkan secara cepat, notifikasi harus dikirim melalui APNs (layanan push notification Apple). Pengiriman ke aplikasi resmi memerlukan kredensial push milik penerbitnya. Karena itu, ntfy meneruskan poll_request yang berisi ID pesan ke ntfy.sh, lalu relay tersebut meneruskannya ke perangkat. Atur upstream-base-url: "https://ntfy.sh" di server.yml, kemudian restart container. Isi pesan tetap diambil dari server Anda. Tanpa pengaturan tersebut, notifikasi iOS tetap dapat tiba pada akhirnya, tetapi dokumentasi ntfy memperingatkan bahwa penundaannya dapat mencapai beberapa jam. PWA menyediakan opsi lain di iOS 16.4 atau yang lebih baru jika Web Push dikonfigurasi di server Anda.
Mengapa alert ntfy dari cron job saya tidak pernah tiba?
Jalankan baris curl secara langsung terlebih dahulu untuk memastikan token dan topik sudah benar. Jika berhasil saat dijalankan secara manual tetapi gagal dari cron, masalahnya terjadi sebelum alert dikirim. Cron menjalankan job dengan environment minimal dan PATH yang singkat, sehingga script yang memanggil perintah berdasarkan nama tanpa path lengkap dapat berhenti sebelum mencapai baris curl. Gunakan path absolut, arahkan output job ke file log, lalu baca file tersebut setelah eksekusi berikutnya. Respons 429, bukan pengiriman pesan, menunjukkan bahwa permintaan ditolak karena batas tertentu. Biasanya script mengulangi permintaan terlalu cepat. Namun, pengunjung yang telah menghabiskan kuota harian, seperti batas pesan yang ditetapkan di atas, akan ditolak dengan cara yang sama meskipun hanya mengirim satu permintaan.
Haruskah saya mengekspos ntfy di Internet publik?
Aplikasi ponsel harus dapat mengaksesnya melalui jaringan seluler. Karena itu, endpoint HTTPS publik dengan auth-default-access: "deny-all" dan ACL per topik merupakan konfigurasi yang umum. Konfigurasi ini aman selama tidak ada topik yang dapat dibaca oleh everyone. Instance yang hanya dapat diakses melalui VPN masuk akal jika semua subscriber adalah mesin yang Anda kendalikan. Namun, konfigurasi tersebut kurang sesuai untuk ponsel karena aplikasi hanya menerima notifikasi saat tunnel aktif. Akibatnya, alert akan berada dalam antrean sampai ponsel tersambung kembali.