PushBits
PushBits is a self-hosted relay server that forwards push notifications to Matrix.
Platform availability
Available on 2 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
37/100 Low
- Maintained
- 42last commit 315 days ago
- Popular
- 51371 GitHub stars
- Easy to install
- 452 install platforms, install notes, Docker image
- Light to run
- No data
- Security check
- 09 serious findings, 4 minor, CI, tests, OpenSSF Scorecard 3.5/10
Based on 4 of 5 factors.
Security check: 8 serious findings
- Uses github.com/jackc/pgx/v5 v5.7.2, which has a known critical vulnerability (Go)
- Uses github.com/jackc/pgx/v5 v5.7.2, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability (Go)
Automated checks on commit fdf5fbd, 2 Nov 2026. Not an audit.
Availability: platform listings confirmed today, links checked 54 days ago
- GitHub stars
- 371
- Open issues
- 9
- Last commit
- 2026-01-10
- Latest release
- v0.10.7
- License
- ISC
- Activity
- stale
Checked 21 days ago - source: GitHub (pushbits/server)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- First-start configuration After the first start, download the configuration example, rename it to config.yml, place it in the PushBits appdata folder, and set Matrix usernames and passwords. source
Fetched 49 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
What Matrix credentials must be provided during first-start configuration?
You need to set Matrix usernames and passwords in config.yml after renaming the downloaded configuration example and placing it in the PushBits appdata folder.
Where are the example configuration and database files, and what permission issue should I check?
The example uses ./data/config.yml for the configuration and ./data/pushbits.db for the SQLite database. Adjust the permissions on the ./data directory, otherwise PushBits will fail to operate.
Do I need to install a separate PushBits app to receive alerts?
No, PushBits does not require an additional app. It delivers notifications through Matrix.
Is there a prebuilt Docker Compose or Swarm stack for PushBits?
Yes, a verified Docker Compose and Swarm stack is available for PushBits, with healthchecks and homepage labels.
Answers sourced from github.com, github.com, pushbits.github.io, pushbits.github.io
Community
Collected 48 days ago - public community threads