Get a loud phone alarm when a release fails
Email is easy to miss at 2 a.m. Phone alarms send an urgent message to your phone through ntfy, a free open-source notification app. They are on Pro.
Set it up
- Open Settings, Phone alarms, and press Set it up for me. We make a private topic, a long random name. Anyone who knows it can read your alerts, so do not share it.
- Install the ntfy app. Use the links on the official site, https://ntfy.sh/, so you get the right one: Google Play, F-Droid or the App Store.
- On your phone, tap the link on the settings screen, or add the topic by hand in the app.
- Android: in the ntfy app, open the notification settings for the Max priority channel, turn the sound up and allow it to override Do Not Disturb. Do this once. On iPhone, allow ntfy in your Focus settings.
- Press Send test alarm and check that your phone makes noise.
When it rings
- Urgent (the loudest): a release that needs attention or failed.
- High: a deploy that failed and was reverted, a merge with no deploy found, or a release that was not merged.
- Nothing for a clean deploy.
The reminder
If nobody opens the release in the app within two hours of a bad outcome, you get one reminder by email and, if set up, on your phone. Opening the release stops it. There is never a second reminder.
Your own ntfy server
If you run your own ntfy server, choose Use my own ntfy server instead and enter its https address, a topic and, if it needs one, an access token. The token is stored on our server and never shown again. Private network addresses are refused.
Limits to know
- The public ntfy.sh server limits how many messages one sender can publish, and all of our alerts come from one server. For a team that wants certainty, use your own server.
- Delivery depends on your phone. On Android, ntfy needs to be allowed to run in the background. A phone that is off or without signal gets the alarm when it comes back.
- The alarm is a second signal, not a guarantee. Keep email on as well.
More guides: Get email, Slack and Discord alerts for every release · Set up automatic revert for a failed deploy