ntfy — Notifikasi Push Ringan

Pernahkah Anda berharap ponsel bisa bergetar begitu sebuah skrip selesai—tanpa perlu menginstal aplikasi apa pun? Itulah keajaiban sehari-hari dari ntfy: ia mengubah topik apa pun menjadi saluran pub-sub yang bisa Anda ping dengan permintaan HTTP sederhana.

Bagi pengguna Hermes Agent, ntfy adalah cara termudah untuk membawa agen AI Anda di saku. Tanpa SDK, tanpa daemon, tanpa Node.js—cukup nama topik dan aplikasi seluler ntfy yang gratis. Begini cara menghubungkannya.

Mengapa ntfy Sangat Cocok dengan Hermes

Hermes identik dengan otomatisasi ringan. ntfy sangat sejalan dengan filosofi tersebut:

• Tanpa dependensi — adaptornya menggunakan httpx, yang sudah disertakan dalam Hermes.
• Klien HTTP apa pun bisa dipakai — curl, Python, bahkan smartwatch.
• Bisa di-host sendiri — jalankan server ntfy Anda sendiri untuk topik privat, atau gunakan ntfy.sh publik yang gratis.

Anda berlangganan ke sebuah topik di ponsel, kirim pesan ke topik tersebut dari Hermes, dan dapatkan balasannya sebagai notifikasi. Ini adalah pesan push tanpa embel-embel.

Memulai dengan Cepat: Wizard Pengaturan

Jalur tercepat adalah melalui pengaturan terpandu:

hermes gateway setup

Pilih ntfy dari menu, masukkan nama topik Anda (misalnya, hermes-myname-2026), dan selesai. Wizard akan menulis konfigurasi ke ~/.hermes/.env.

Konfigurasi Manual melalui Variabel Lingkungan

Lebih suka mengedit file? Tambahkan ini ke ~/.hermes/.env:

NTFY_TOPIC=hermes-myname-2026
NTFY_ALLOWED_USERS=hermes-myname-2026
NTFY_HOME_CHANNEL=hermes-myname-2026

Itu adalah konfigurasi minimum. Berikut penjelasan setiap variabel:

Variabel	Wajib	Tujuan
NTFY_TOPIC	Ya	Topik untuk berlangganan (pesan masuk)
NTFY_SERVER_URL	Tidak	Default https://ntfy.sh; arahkan ke server sendiri untuk privasi
NTFY_TOKEN	Tidak	Token Bearer (tk_xyz) atau user:pass untuk autentikasi
NTFY_PUBLISH_TOPIC	Tidak	Topik terpisah untuk balasan (default ke NTFY_TOPIC)
NTFY_MARKDOWN	Tidak	Set true untuk mengirim balasan dengan X-Markdown: true
NTFY_ALLOWED_USERS	Disarankan	Daftar nama topik yang dipisahkan koma, diperlakukan sebagai ID pengguna
NTFY_ALLOW_ALL_USERS	Tidak	Izinkan semua publisher — hanya aman untuk topik privat
NTFY_HOME_CHANNEL	Tidak	Topik default untuk cron / notifikasi
NTFY_HOME_CHANNEL_NAME	Tidak	Label yang mudah dibaca untuk saluran utama

Model Identitas: Baca Ini Sebelum Menyebarkan

Inilah kelemahan ntfy: ia tidak memiliki akun pengguna sungguhan. Kolom title pada sebuah pesan dikendalikan oleh publisher—siapa pun bisa memalsukannya. Jadi Hermes tidak menggunakan title untuk otorisasi.

Sebagai gantinya, nama topik itulah yang menjadi identitas. Setiap pesan di topik tersebut diperlakukan berasal dari pengguna logis yang sama. NTFY_ALLOWED_USERS biasanya hanya nama topik itu sendiri—daftar izin dengan satu entri.

Implikasi keamanan: siapa pun yang mengetahui topik Anda dapat berbicara dengan agen Anda. Untuk menjadikan ini batas kepercayaan yang nyata:

• Host ntfy sendiri dan kunci topik dengan Access Control.
• Hanya klien yang berwenang yang dapat mempublikasikan atau berlangganan.

Tips Praktis untuk Penggunaan Sehari-hari

Set NTFY_MARKDOWN=true jika Anda ingin balasan berformat (tebal, daftar, blok kode) ditampilkan dengan rapi di aplikasi ntfy. Ini membuat respons agen yang panjang jauh lebih mudah dipindai di layar ponsel.

Penutup

ntfy memberi Hermes saluran push yang sangat sederhana: berlangganan di ponsel, konfigurasikan tiga variabel lingkungan, dan Anda langsung aktif. Tanpa akun cloud, tanpa layanan tambahan, tanpa kurva belajar.

Tips terakhir: mulailah dengan topik unik seperti hermes-<namamu>-<tahun>—praktis mustahil bentrok di server publik. Kemudian, setelah Anda percaya dengan alur kerjanya, host ntfy sendiri dan tambahkan kontrol akses untuk saluran yang benar-benar privat. Agen Anda kini hanya berjarak satu getaran.

---