easychen/pushdeer
Pushdeer
Pushdeer is a self-hosted push notification service designed to deliver instant alerts to mobile devices and IoT hardware. It functions as a centralized backend for managing and routing custom notifications via a private server.
The system is distinguished by its appless push notification capability, which leverages native operating system features to receive alerts without requiring a dedicated client application installed on the handset. For IoT integration, it operates as a messaging gateway using the MQTT protocol to send real-time text and image notifications to smart hardware.
The platform includes a comprehensive management suite for API keys and device registration tokens to secure the notification pipeline. It supports external notification forwarding from third-party platforms via custom JSON formats and provides topic-based routing to direct specific content types to targeted devices. Hardware-specific capabilities include image rendering on device screens, network time synchronization, and the ability to trigger physical alerts like buzzers.
The backend is provided as a containerized environment designed for deployment using Docker and Compose.
Features
- Cloud Push Notification Deliveries - Functions as a centralized server for delivering instant push notifications to both mobile devices and IoT hardware.
- Appless Deliveries - Delivers push notifications to mobile devices without requiring a dedicated client application installed on the handset.
- Appless Notifications - Sends instant alerts to mobile devices without requiring a dedicated application installed on the handset.
- IoT Notification Messaging - Sends real-time text and image notifications to smart hardware via the MQTT protocol for physical alerts.
- IoT Notification Delivery - Sends real-time text and image notifications to smart hardware using the MQTT protocol for physical alerts.
- MQTT Traffic Routing - Uses an MQTT publish-subscribe model to route real-time text and image notifications to IoT hardware.
- Appless Notification Systems - Utilizes native OS capabilities to receive notifications via QR code setup instead of app installs.
- Self-Hosted Push Notification Platforms - Provides a self-hosted server for sending instant alerts to mobile devices and hardware without a dedicated client app.
- Appless Receivers - Provides a lightweight mechanism to receive notifications on mobile devices without installing a dedicated client application.
- Self-Hosted - Provides a private, self-hosted backend using containers to manage and route custom alerts.
- API Key Management - Provides a management suite for creating and rotating secure API keys to route messages to specific devices.
- Notification Pipeline Authorization - Secures the notification pipeline by requiring unique API keys to validate requests from third-party senders.
- Device Registration Services - Links physical hardware and mobile clients to user accounts using unique registration tokens.
- MQTT Notification Integrations - Functions as a messaging bridge that pushes text and image alerts to smart hardware via MQTT.
- Self-Hosted Deployments - Allows deployment of a private backend instance using containers for full control over data and delivery.
- IoT Image Rendering - Renders images on IoT device screens by sending image URLs to a dedicated topic.
- Push Notification Forwarding - Routes alerts from third-party platforms to personal devices using custom JSON formats to bridge different systems.
- Topic-Based Messaging - Routes specific content types like images or text to targeted devices using themed communication channels.
- API Key Lifecycle Management - Provides administrative tools to create, rename, and rotate API keys used to authorize and route notifications.
- Webhook Integrations - Provides a mechanism to receive and process custom JSON alerts from third-party platforms via webhooks.
