Repolode
Submit
easychen

easychen/pushdeer

Self-hostable push notification service that sends messages to iOS, Mac, Android and DIY devices via a simple URL or API call, no app required for basic use.

Open-source alternative to:PushoverBark

View on GitHub
Stars
5,028
Forks
513
Open issues
61
Last commit
11 days ago

What is it?

PushDeer is a push notification service that can be run on your own server. Its main idea is that a user can receive messages without installing a dedicated app: on iOS 14+ a lightweight App Clip is opened by scanning a code, and the same messages can also be delivered through native iOS, Mac and Android clients or a DIY ESP8266/ESP32 device.

Sending a message is a plain HTTP request. After registering a device and creating a push key in the client, you call the message/push endpoint with the key and text, optionally adding a markdown body or an image type. Official SDKs for Python, Go and Rust are maintained by community contributors, and the project includes a PHP helper example and a Server酱 integration for existing tools.

The server side is a Laravel API deployable with docker-compose, with a gorush-based push microservice. The project notes that self-hosted servers need their push certificates renewed yearly, and that the Android client is no longer maintained.

Key features

  • 01Sends text, image and markdown messages through a simple HTTP URL.
  • 02Works on iOS 14+ through an App Clip without a full app install.
  • 03Provides native iOS, Mac and Android clients.
  • 04Can be self-hosted with docker-compose.
  • 05Supports a DIY ESP8266/ESP32 device as a receiver.

Use cases

  • Getting alerts from scripts, cron jobs or servers on your phone.
  • Pushing router, NAS or public IP status notifications.
  • Sending error reports from your own application to a mobile device.
  • Forwarding notifications from tools that already support Server酱.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/easychen/pushdeer.git
  2. 2

    Enter the project folder

    cd pushdeer
  3. 3

    Start the self-hosted server with Docker Compose (requires Docker and docker-compose on the server)

    docker-compose -f docker-compose.self-hosted.yml up --build -d

Things to know

  • The project is no longer maintained, and the official Android client and API no longer receive new features.
  • Self-hosted servers need their push certificates updated every year.
  • The license forbids commercial use, so it is not suitable for paid services.

In collections

Self-hosted apps

Topics

#push-notification#self-hosted#notifications#laravel#docker#iot#app#clip#notification-service#push

FAQ

What is pushdeer?
Self-hostable push notification service that sends messages to iOS, Mac, Android and DIY devices via a simple URL or API call, no app required for basic use. PushDeer is a push notification service that can be run on your own server. Its main idea is that a user can receive messages without installing a dedicated app: on iOS 14+ a lightweight App Clip is opened by scanning a code, and the same messages can also be delivered through native iOS, Mac and Android clients or a DIY ESP8266/ESP32 device.
Is pushdeer free to use? What license does it have?
pushdeer is open source under the Other license. Check the license terms before using it in commercial products.
Is pushdeer still maintained?
Actively maintained. The last commit to pushdeer was on Oct 28, 2026.
What can I use pushdeer for?
Getting alerts from scripts, cron jobs or servers on your phone. Pushing router, NAS or public IP status notifications. Sending error reports from your own application to a mobile device. Forwarding notifications from tools that already support Server酱.
How do I install pushdeer?
Clone the repository: git clone https://github.com/easychen/pushdeer.git Enter the project folder: cd pushdeer Start the self-hosted server with Docker Compose (requires Docker and docker-compose on the server): docker-compose -f docker-compose.self-hosted.yml up --build -d
Where can I get pushdeer?
The source code and installation instructions are on GitHub: https://github.com/easychen/pushdeer

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects