# Notifikasi Proxmox ke ponsel Anda: backup, fencing, replikasi, dan error disk

> Kirim notifikasi Proxmox VE dan Proxmox Backup Server ke iPhone dan Android lewat target webhook bawaan. Backup yang gagal masuk dengan keras, yang berhasil masuk pelan, node yang di-fence membangunkan Anda, dan peringatan smartd serta ZFS tidak lagi mati di kotak surat root.

*25.10.2026*

<!-- source: https://pocketalert.app/id/blog/proxmox-alerts -->

Kebanyakan host Proxmox mengirim notifikasi ke `root@pam`, yaitu alamat email yang diketik di installer bertahun-tahun lalu, dikirim lewat Postfix yang tidak pernah diberi relay. Backup malam hari gagal, email masuk ke antrean lokal, dan Anda baru tahu tiga minggu kemudian saat perlu memulihkan VM.

Pengaturan umum lainnya memang berfungsi, tetapi diabaikan. Setiap job backup mengirim email panjang setiap malam, semuanya bertuliskan "successful", dan yang bertuliskan "failed" terlihat persis seperti tiga puluh email lainnya di folder.

Sejak Proxmox VE 8.3 dan Proxmox Backup Server 3.3, sistem notifikasi memiliki target **webhook** generik. Target ini dapat memanggil API HTTP apa pun dengan body yang Anda tulis sendiri, jadi bisa mengirim push langsung ke ponsel, dengan prioritas berbeda untuk kegagalan dan keberhasilan. Tanpa skrip di host dan tanpa relay yang perlu dirawat.

## Yang Anda butuhkan

- Proxmox VE 8.3 atau yang lebih baru (versi 9.x mana pun berfungsi), atau Proxmox Backup Server 3.3 atau yang lebih baru. Versi lama dibahas di bagian bawah.
- Aplikasi Pocket Alert di [iPhone atau Android](/get-app) dan kunci API dari [Kunci API](/account/apikeys).
- Akses ke Datacenter → Notifications sebagai `root@pam` atau pengguna dengan `Mapping.Modify` pada `/mapping/notifications`.

## Apa yang bisa diberitahukan Proxmox

Proxmox VE mengeluarkan event berikut, masing-masing dengan `type`, tingkat keparahan, dan beberapa field metadata:

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>Event</th><th><code>type</code></th><th>Keparahan</th></tr></thead>
<tbody>
<tr><th>Backup berhasil</th><td><code>vzdump</code></td><td><code>info</code></td></tr>
<tr><th>Backup gagal</th><td><code>vzdump</code></td><td><code>error</code></td></tr>
<tr><th>Job replikasi storage gagal</th><td><code>replication</code></td><td><code>error</code></td></tr>
<tr><th>Node cluster di-fence</th><td><code>fencing</code></td><td><code>error</code></td></tr>
<tr><th>Pembaruan sistem tersedia</th><td><code>package-updates</code></td><td><code>info</code></td></tr>
<tr><th>Email untuk root (smartd, ZFS ZED, dan lainnya)</th><td><code>system-mail</code></td><td><code>unknown</code></td></tr>
</tbody>
</table>
</div>

Baris terakhir lebih penting daripada kelihatannya. `smartd` memeriksa disk Anda setiap 30 menit dan mengirim email ke root saat satu disk mulai bermasalah, sementara daemon event ZFS mengirim email ke root tentang pool yang terdegradasi dan error scrub (`ZED_EMAIL_ADDR="root"` adalah default). Proxmox mengubah email tersebut menjadi event `system-mail`, sehingga webhook yang sama yang melaporkan backup juga melaporkan disk yang sekarat.

## Siapkan target webhook

Di antarmuka web, buka **Datacenter → Notifications**, lalu di bawah **Notification Targets** klik **Add → Webhook**. Isi seperti berikut:

- **Endpoint Name:** `pocketalert`
- **Method/URL:** `POST` dan `https://api.pocketalert.app/v1/messages`
- **Headers:** `Content-Type` = `application/json`, dan `Token` = `{{ secrets.token }}`
- **Secrets:** `token` = kunci API Pocket Alert Anda

Dan **Body**-nya:

```
{
  "title": {{ json title }},
  "message": {{ json message }},
  "level": "{{#if (or (eq severity "error") (eq severity "unknown"))}}high{{else}}low{{/if}}"
}
```

Ada beberapa hal yang terjadi di sini:

- **`{{ json title }}` menampilkan nilai sebagai string JSON lengkap**, termasuk tanda kutipnya. Laporan backup berupa tabel multi-baris, dan menempelkan `{{ message }}` di antara tanda kutip akan merusak JSON pada baris baru pertama. Proxmox juga punya `{{ escape message }}`, yang melakukan hal yang sama tanpa tanda kutip di sekelilingnya.
- **Kuncinya adalah secret.** Secret disimpan di `/etc/pve/priv/notifications.cfg`, hanya bisa dibaca root, dan API tidak pernah mengembalikan nilainya. Proxmox juga menyembunyikannya dari pesan error.
- **Level mengikuti keparahan.** Proxmox merender body dengan Handlebars, yang memiliki `if`, `eq`, dan `or`. Backup gagal, replikasi gagal, fencing, dan email disk tiba sebagai `high`, yang menembus Fokus di iPhone. Backup berhasil dan pemberitahuan pembaruan tiba sebagai `low`: notifikasi tersebut ada di feed jika Anda menginginkannya, dan tidak bergetar.

Simpan target lalu klik **Test**. Notifikasi uji seharusnya tiba dalam beberapa detik.

Target ini tidak melakukan apa pun sampai sebuah matcher mengarahkan event ke sana. Di bawah **Notification Matchers**, klik **Add**, beri nama `pocketalert-all`, lalu di tab **Targets to notify** centang `pocketalert`. Matcher tanpa aturan mencocokkan setiap event.

### Hal yang sama dari shell

Jika Anda lebih suka CLI, atau mengelola beberapa cluster, `pvesh` melakukan hal yang sama. Nilai header, body, dan secret diteruskan dalam format base64:

```bash
PA_KEY='your-api-key'
BODY='{
  "title": {{ json title }},
  "message": {{ json message }},
  "level": "{{#if (or (eq severity "error") (eq severity "unknown"))}}high{{else}}low{{/if}}"
}'
b64() { printf '%s' "$1" | base64 -w0; }

pvesh create /cluster/notifications/endpoints/webhook \
  --name pocketalert --method post \
  --url https://api.pocketalert.app/v1/messages \
  --header "name=Content-Type,value=$(b64 application/json)" \
  --header "name=Token,value=$(b64 '{{ secrets.token }}')" \
  --secret "name=token,value=$(b64 "$PA_KEY")" \
  --body "$(b64 "$BODY")"

pvesh create /cluster/notifications/matchers --name pocketalert-all --target pocketalert
pvesh create /cluster/notifications/targets/pocketalert/test
```

Hasilnya tersimpan di `/etc/pve/notifications.cfg`, yang dibagikan di seluruh cluster, sehingga satu pengaturan mencakup setiap node (body base64 disingkat di sini):

```
webhook: pocketalert
	method post
	url https://api.pocketalert.app/v1/messages
	header name=Content-Type,value=YXBwbGljYXRpb24vanNvbg==
	header name=Token,value=e3sgc2VjcmV0cy50b2tlbiB9fQ==
	body ewogICJ0aXRsZSI6IHt7IGpzb24gdGl0bGUgfX0s...

matcher: pocketalert-all
	target pocketalert
```

Kuncinya sendiri berada di `/etc/pve/priv/notifications.cfg` sebagai `secret name=token,value=<base64>`.

## Tingkat kedua: node yang di-fence harus membangunkan Anda

Backup yang gagal bisa menunggu sampai pagi. Node yang di-fence berarti HA baru saja mematikan sebuah host, dan itu layak mendapat push `critical` yang tembus Jangan Ganggu. Matcher bisa melakukan ini tanpa menyentuh template body.

Buat target webhook kedua, `pocketalert-critical`, yang identik dengan yang pertama kecuali satu baris pada body:

```
  "level": "critical"
```

Lalu ganti matcher catch-all dengan dua matcher yang memisahkan berdasarkan tipe event:

```
matcher: pocketalert-all
	match-field exact:type=fencing
	invert-match true
	target pocketalert

matcher: pocketalert-fencing
	match-field exact:type=fencing
	target pocketalert-critical
```

`invert-match` membalik matcher pertama, sehingga fencing hanya dikirim ke target critical dan Anda tidak mendapat dua push untuk satu event. Pengiriman `critical` yang tembus Jangan Ganggu adalah fitur paket berbayar; di paket Gratis ia tiba sebagai `high`. Lihat [level prioritas](https://info.pocketalert.app/features/priority-levels.html) untuk apa yang dilakukan tiap level di iOS dan Android.

Hal lain yang bisa dilakukan matcher:

- **Hanya kegagalan.** Tambahkan `match-severity error,unknown` ke `pocketalert-all` dan backup yang berhasil berhenti mengirim apa pun. Kami tetap menyimpannya sebagai `low`: notifikasi "backup successful" yang senyap setiap malam adalah cara termudah untuk menyadari kapan notifikasi itu berhenti datang.
- **Satu job.** `match-field exact:job-id=backup-abc123` membatasi matcher ke satu job terjadwal. Backup yang dimulai dengan **Run now** tidak memiliki `job-id`, sehingga tidak akan cocok.
- **Jam tenang.** `match-calendar mon..fri 9-17` membatasi matcher ke jam kerja, dan `invert-match` memberi Anda sisanya.

### Tombol yang membuka antarmuka web

Push Pocket Alert bisa membawa hingga tiga [tombol aksi](https://info.pocketalert.app/features/action-buttons.html). Tambahkan satu ke body dan backup yang gagal membuka antarmuka Proxmox dengan satu ketukan:

```
  "actions": [
    {"type": "view", "label": "Open Proxmox", "value": "https://pve1.lan:8006"}
  ]
```

Ponsel membuka URL itu sendiri, sehingga alamat lokal berfungsi kapan pun Anda berada di jaringan rumah atau VPN.

## Proxmox Backup Server

PBS 3.3 dan yang lebih baru memiliki sistem notifikasi yang sama di bawah **Configuration → Notifications**, dengan target webhook yang sama, body yang sama, dan helper Handlebars yang sama. Konfigurasinya tersimpan di `notifications.cfg` dan `notifications-priv.cfg` di bawah `/etc/proxmox-backup/`.

Event-nya berbeda dan lebih berguna untuk backup server: garbage collection (`gc`), `prune`, `sync`, `verification`, `tape-backup` dan `tape-load`, ditambah kegagalan pembaruan sertifikat `acme` dan `package-updates`. `acme` hanya melaporkan kegagalan dan `tape-load` berupa `notice`; sisanya datang dalam versi `info` dan `error`, sehingga `if` yang sama di body berfungsi tanpa perubahan. Event datastore (`gc`, `prune`, `sync`, `verification`, `tape-backup`) juga membawa field `datastore`, sehingga `match-field regex:datastore=^offsite-.*$` dapat mengirim datastore offsite ke target yang berbeda.

Dua hal PBS yang perlu diperiksa. Datastore yang dibuat sebelum sistem notifikasi memiliki `notification-mode` yang mungkin masih `legacy-sendmail`; ubah ke sistem notifikasi di opsi datastore. Dan PBS hanya mengirim notifikasi `package-updates` pada host dengan langganan aktif.

## Batasan yang jujur

- **Host harus online untuk melapor.** Webhook dikirim oleh host Proxmox itu sendiri, jadi jika kehilangan uplink atau dimatikan, tidak ada yang keluar. Untuk "seluruh perangkat mati", Anda memerlukan pengecekan dari luar, misalnya uptime monitor di mesin lain.
- **Laporan backup yang panjang dipotong dalam push.** Backup dua puluh guest menghasilkan tabel yang panjang. Push menampilkan sekitar 3 KB pertama; teks lengkapnya ada di riwayat pesan di aplikasi.
- **`system-mail` adalah semua yang dikirim ke root.** Itu mencakup smartd dan ZFS, tetapi juga output cron dan apa pun lain yang mengirim email ke root di sistem Anda. Jika terlalu berisik, berikan event tersebut matcher sendiri dengan `match-field exact:type=system-mail` dan target yang lebih senyap.
- **Tidak ada kompatibilitas Gotify.** Proxmox juga punya target Gotify bawaan, dan panduan lama memakainya untuk push ke ponsel. Pocket Alert tidak mengimplementasikan API Gotify, sehingga target itu tidak bisa mengarah ke kami. Gunakan target webhook di atas, atau lihat [perbandingan Pocket Alert dengan Gotify](/alternatives/gotify).

## Pada Proxmox VE 8.2 ke bawah

Meningkatkan versi adalah solusi terbaik, karena target webhook memerlukan 8.3. Jika belum bisa meningkatkan, sebuah hook skrip vzdump mencakup kasus paling penting, yaitu backup. Pasang [Pocket Alert CLI](/tools/cli) di node sebagai root, jalankan `pocketalert auth`, lalu simpan ini sebagai `/usr/local/bin/vzdump-pocketalert`:

```bash
#!/bin/sh
case "$1" in
  backup-abort) pocketalert send -t "Backup failed: $3 on $(hostname)" -m "Mode: $2" -l high ;;
  job-end)      pocketalert send -t "Backup job finished on $(hostname)" -m "Check the task log for details" -l low ;;
esac
exit 0
```

Jadikan file itu executable dan tambahkan `script: /usr/local/bin/vzdump-pocketalert` ke `/etc/vzdump.conf`. vzdump memanggilnya di setiap fase; untuk `backup-abort`, argumen kedua dan ketiga adalah mode backup dan ID VM.

## Jika tidak ada yang masuk

- **Jalankan Test terlebih dahulu.** Jika push uji tiba tetapi event sungguhan tidak, targetnya sudah benar dan masalahnya ada di routing: periksa apakah sebuah matcher menyebut target tersebut dan apakah aturannya cocok.
- **Lihat mode notifikasi job backup.** Job yang memiliki alamat email di pengaturan notifikasinya dan mode default `auto` memakai legacy sendmail dan melewati sistem notifikasi sepenuhnya. Hapus alamatnya atau atur mode ke sistem notifikasi; di `/etc/pve/jobs.cfg` bentuknya `notification-mode notification-system`.
- **Baca journal.** `journalctl --since "1 hour ago" | grep -i notif` menampilkan permintaan yang gagal. `401` berarti kuncinya salah, `400` biasanya berarti body bukan JSON yang valid: pastikan Anda memakai `{{ json message }}` dan bukan `{{ message }}` polos.
- **Periksa feed di aplikasi.** Push `low` tidak berbunyi, sehingga backup yang berhasil bisa terlihat seperti tidak pernah tiba. Notifikasinya ada di riwayat pesan.

## FAQ

### Apakah saya memerlukan langganan Proxmox?

Tidak. Sistem notifikasi dan target webhook adalah bagian dari repositori gratis. Satu-satunya komponen yang bergantung langganan adalah notifikasi `package-updates` pada PBS.

### Apakah ini berfungsi untuk satu node tanpa cluster?

Ya. Satu node membaca `/etc/pve/notifications.cfg` yang sama. Dalam cluster file itu dibagikan, jadi Anda cukup menyiapkannya sekali.

### Bisakah saya mendapatkan ini juga lewat email?

Bisa. Pertahankan target `mail-to-root` bawaan di matchernya dan tambahkan `pocketalert` di sebelahnya. Sebuah matcher bisa memberi notifikasi ke beberapa target, dan setiap target menerima notifikasi paling banyak satu kali.

### Berapa banyak push yang akan dipakai?

Satu per event. Job backup malam hari adalah satu notifikasi untuk seluruh job, bukan satu per guest, jadi homelab biasa mengirim beberapa notifikasi sehari. Paket Gratis mencakup 50 pesan per hari untuk satu perangkat.

### Bagaimana dengan TrueNAS, event daya UPS, atau Uptime Kuma?

Idenya sama, pengirimnya berbeda. Halaman [peringatan homelab](/use-cases/homelab-alerts) membahas bagian-bagian umum dari rak server rumahan, dan [peringatan backup](/use-cases/backup-alerts) membahas alat backup selain Proxmox.

[Buat akun gratis](/signup), tempelkan body ke target webhook, dan biarkan backup gagal berikutnya menemukan Anda, bukan kotak masuk Anda.
