Getting started

Notify pops a card on your desktop whenever something you care about happens — a deploy finishes, an alert fires, or a script wants to ping you. Three steps to your first one: install the app, create a token, send a message.

1. Install the app

Notify is a small app that lives in your menu bar / tray (a few MB on disk, almost no memory). Grab the installer for your platform from the latest release. The builds aren't signed yet, so the first time you open it: on macOS right-click the app and choose Open; on Windows click More info → Run anyway.

2. Sign in and create a token

Open the app and click Sign in with browser. It signs you in through this site and hands the session back to the app automatically — no copy-pasting. Once you're in, go to Webhook & tokens in the app's sidebar and create a token. It looks like ntfy_… and is shown only once, so copy it right away. Tip: make one token per sender (your CI, a cron job, a monitor) so you can turn any of them off on its own.

3. Send your first message

Anything that can make an HTTP request can send to Notify. The simplest message is a single line of text:

curl -d "Hello from my script 👋" \
  https://notify-server.saasflare.dev/v1/send/ntfy_...

A card pops on your desktop within a second. If the app is closed or offline, the message waits for you and shows up the moment you're back. Ready for titles, status and buttons? Head to Sending.