.. _push_notifications:

Push Notifications
==================

.. versionadded:: 1.7

.. note::

   This feature is optional.

To enable push notifications, simply run the ``gen_vapid_keys`` management command and add the following to your
``settingslocal.py``::

   PUSH_ENABLED = True
   VAPID = {
      'PRIVATE_KEY': 'private_key.pem',
      'PUBLIC_KEY': 'public_key.pem',
      'SUB': 'mailto:youremail@example.org',
   }

You can pass ``--public-key /path/to/public.key`` and ``--private-key /path/to/private.key`` to put the keys in another
location if desired, just make sure to update the ``PRIVATE_KEY`` and ``PUBLIC_KEY`` settings to match.