https://github.com/mozilla-services/autopush-rs

Push Server in Rust
https://github.com/mozilla-services/autopush-rs

aws dynamodb rust services-engineering-team tokio-rs

Last synced: 1 day ago
JSON representation

Push Server in Rust

• Host: GitHub
• URL: https://github.com/mozilla-services/autopush-rs
• Owner: mozilla-services
• License: mpl-2.0
• Created: 2018-05-31T20:17:30.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2025-01-10T16:21:14.000Z (4 days ago)
• Last Synced: 2025-01-10T22:14:08.304Z (3 days ago)
• Topics: aws, dynamodb, rust, services-engineering-team, tokio-rs
• Language: Rust
• Homepage:
• Size: 4.13 MB
• Stars: 205
• Watchers: 23
• Forks: 16
• Open Issues: 76
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome - mozilla-services/autopush-rs - Push Connection Node in Rust (rust)

README

        
[![License: MPL 2.0][mpl-svg]][mpl]

[![Build Status][circleci-badge]][circleci]

[![docs][docs-badge]][docs]

[![autoconnect API][autoconnect-API-docs-badge]][autoconnect-API-docs]

[![autoendpoint API][autoendpoint-API-docs-badge]][autoendpoint-API-docs]

[![Open #push Matrix room in chat.mozilla.org web client][matrix-badge]][matrix]

# Autopush-rs

Mozilla Push server built with [Rust](https://rust-lang.org).

This is the fourth generation of the Mozilla Web Push server. It currently supports websocket connections

and support for

[Megaphone](https://github.com/mozilla-services/megaphone) broadcast.

Please consult the [autopush documentation][docs] for information

about how this server works, as well as any [error messages] you may

see when sending push messages to our server.

MDN has information about [how to use

WebPush](https://developer.mozilla.org/en-US/docs/Web/API/Push_API).

***Note*** while `rust-doc` style comments are used prolifically

through the source, only public structures are rendered automatically.

For those curious about the inner workings, You may wish to read the

code files directly.

## Debugging on Mobile

Mobile devices can specify the Push Server URL via the "[secret settings](https://firefox-source-docs.mozilla.org/mobile/android/fenix/Secret-settings-debug-menu-instructions.html)".

_Do not use the mobile `about:config` menu settings. These are not read or used by the mobile browser._

The secret settings can be activatedby following [these instructions](https://firefox-source-docs.mozilla.org/mobile/android/fenix/Secret-settings-debug-menu-instructions.html). Once the secret menu is active, select

**Sync Debug** from the the mobile **Settings** menu, and specify the **Custom Push server** URL.

**NOTE:** the default Push server url is `wss://push.services.mozilla.com/`

[mpl-svg]: https://img.shields.io/badge/License-MPL%202.0-blue.svg

[mpl]: https://opensource.org/licenses/MPL-2.0

[circleci-badge]: https://circleci.com/gh/mozilla-services/autopush-rs.svg?style=shield

[circleci]: https://circleci.com/gh/mozilla-services/autopush-rs

[autoconnect-API-docs-badge]: https://img.shields.io/badge/autoconnect%20API%20-%20docs%20-%20light%20green

[autoconnect-API-docs]: https://mozilla-services.github.io/autopush-rs/api/autoconnect/

[autoendpoint-API-docs-badge]: https://img.shields.io/badge/autoendpoint%20API%20-%20docs%20-%20light%20green

[autoendpoint-API-docs]: https://mozilla-services.github.io/autopush-rs/api/autoendpoint/

[docs-badge]: https://github.com/mozilla-services/autopush-rs/actions/workflows/publish_docs.yml/badge.svg

[docs]: https://mozilla-services.github.io/autopush-rs/

[matrix-badge]: https://img.shields.io/badge/chat%20on%20[m]-%23push%3Amozilla.org-blue

[matrix]: https://chat.mozilla.org/#/room/#push:mozilla.org

[error messages]: https://mozilla-services.github.io/autopush-rs/errors.html