# Gorush

Push notification server that sends iOS, Android and Huawei notifications through a web API, a command line or gRPC.


Source: https://findsoftware.frbit.cloud/gorush/
Last reviewed: 2026-11-03
Listed since: 2026-11-03

## Record

### Links

- repository: https://github.com/appleboy/gorush
- docs: https://github.com/appleboy/gorush/blob/v1.22.0/README.md

### Identity

- status: active
- maintainer: Bo-Yi Wu
- maintainerType: individual
- parent: unknown
- firstRelease: 2016
- hqCountry: unknown

### Kind

- category: backend
- hosting: binary
- language: go
- runtime: binary
- runtimeMin: unknown
- basedOn: unknown

### Content

- contentStore: unknown
- databases: unknown
- adminUi: unknown
- headlessApi: unknown
- templating: unknown
- i18n: unknown

### Rendering and deploy

- runsAs: always-on
- renderingModes: unknown
- installMethod: install script (install.sh) from the master branch

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 1
- latestReleaseDate: 2026-07-25

### Adoption

- githubStargazers: 8796
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 59
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: unknown
- dependentPackages: unknown

### Sources

- urls: https://api.github.com/repos/appleboy/gorush (read 2026-11-03)
- urls: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- maintainer: https://github.com/appleboy/gorush/blob/v1.22.0/LICENSE (read 2026-11-03)
- maintainerType: https://github.com/appleboy/gorush/blob/v1.22.0/LICENSE (read 2026-11-03)
- firstRelease: https://api.github.com/repos/appleboy/gorush/commits/8645e17060ded2f5b6446fd08f97e884653087fb (read 2026-11-03)
- category: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- language: https://api.github.com/repos/appleboy/gorush (read 2026-11-03)
- runtime: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- installMethod: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- installMethod: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- installMethod: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- installMethod: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- installMethod: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- installMethod: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- installMethod: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- runsAs: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- license: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- licenseModel: https://github.com/appleboy/gorush/blob/v1.22.0/README.md (read 2026-11-03)
- currentMajor: https://github.com/appleboy/gorush/releases/tag/v1.22.0 (read 2026-11-03)
- latestReleaseDate: https://api.github.com/repos/appleboy/gorush/releases/latest (read 2026-11-03)
- githubStargazers: https://api.github.com/repos/appleboy/gorush (read 2026-11-03)
- contributors: https://api.github.com/repos/appleboy/gorush/contributors?per_page=1 (read 2026-11-03)

## Notes

Gorush is a server that sends push notifications to iOS, Android and Huawei devices. An application calls the server's web API at `/api/push`, and the server passes the message on to the platform's push service. It is written in Go, is configured with a YAML file and listens on port 8088 by default. Notifications go through a queue handled by multiple workers. Delivery statistics can be kept in memory, in Redis or in one of several embedded stores. Prometheus metrics, a gRPC service and a command line for single messages are also part of the project. The README describes running it in Docker, on Kubernetes or as an AWS Lambda function.

## Worth knowing

Each platform needs its own credentials in the configuration: a Firebase service account key for Android and an APNs key file for iOS. The queue's default is an in-process channel, and the README names NSQ, NATS and Redis streams as queue backends the operator can choose instead.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0