Get started

Quickstart

1. Create an account

   Sign up with your email. Free needs no card.

2. Add your phone

   Open bzzd.io on the phone, sign in and allow notifications. On iPhone and iPad, first tap Share → Add to Home Screen and open bzzd from there: Apple only allows web notifications for apps on the Home Screen (iOS 16.4 or later). Add your computer the same way, from its browser.

3. Make an app

   One for each thing that sends alerts, like your backups or Uptime Kuma. Pick the service, and bzzd shows where its URL goes.

4. Send something

   Paste the URL into the service, or post to it yourself:

   curl -d "Backup finished on nas-01" https://api.bzzd.io/v1/hooks/APP_TOKEN

Your own code and jobs

• Sending messages Fields, priorities, images, urgent alerts that repeat, errors and limits.
• Heartbeat checks Get an alert when a cron job or backup doesn't run.

Services

Each of these posts its own format; bzzd reads it and writes the notification for you.

• Dokploy Deploys, failed builds, backups and server alerts.
• Uptime Kuma Monitors going down and coming back up.
• Grafana Alerts from Grafana alerting.
• Prometheus Alertmanager Firing and resolved Prometheus alerts.
• Sonarr, Radarr or Lidarr Grabs, downloads, upgrades and health warnings.
• GitHub Pushes, pull requests, issues, releases and failed workflow runs.
• Gitea or Forgejo Pushes, pull requests, issues and releases.
• Sentry Alert rules, new and resolved issues, and errors.
• Home Assistant Notifications from automations and scripts.
• Healthchecks.io Cron jobs and backups that stop checking in.
• Zabbix Problems and recoveries from Zabbix triggers.
• Anything that supports ntfy Apprise, changedetection.io and other tools with an ntfy option.
• Anything that supports Gotify Tools with a Gotify option.