Skip to content

Configure Zulip: Push notifications

  1. Uncomment the PUSH_NOTIFICATION_BOUNCER_URL = 'https://push.zulipchat.com' line in your /etc/zulip/settings.py file (i.e. remove the # at the start of the line), and restart your Zulip server.
  2. Run the registration command:
# As root:
su zulip -c '/home/zulip/deployments/current/manage.py register_server'
# Or as the zulip user, you can skip the `su zulip -c`:
/home/zulip/deployments/current/manage.py register_server
  1. You’ll each need to log out and log back in again in order to start getting push notifications.

Check

If you’d like to verify that everything is working, you can do the following. Please follow the instructions carefully:

Configure mobile push notifications to always be sent (normally they’re only sent if you’re idle, which isn’t ideal for this sort of testing).

On an Android device, download and log in to the Zulip Android app. If you were already logged in before configuring the server, you’ll need to log out first, since the app only registers for push notifications on login.

Hit the home button, so Zulip is running in the background, and then have another user send you a private message (By default, Zulip only sends push notifications for private messages sent by other users and messages mentioning you). A push notification should appear in the Android notification area.