# PushBits

PushBits is a self-hosted relay server that forwards push notifications to Matrix. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/289/pushbits

## Description

PushBits is a self-hosted relay server that forwards push notifications to Matrix. It accepts notifications through a simple application programming interface (API) and delivers them to configured Matrix users. It suits homelab users who want Pushover-like alerts without installing a separate mobile app, and it includes the pbcli command-line tool for sending test messages.

## Platform availability

Available on 2 of 10 platforms: Unraid, Any server.

## Health score

37/100 (Low), based on 4 of 5 factors.
- Maintained: 42 (last commit 315 days ago)
- Popular: 51 (371 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Security check: 0 (9 serious findings, 4 minor, CI, tests, OpenSSF Scorecard 3.5/10)

## Security check

8 serious findings: Uses github.com/jackc/pgx/v5 v5.7.2, which has a known critical vulnerability; Uses github.com/jackc/pgx/v5 v5.7.2, which has a known critical vulnerability; Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.38.0, which has a known critical vulnerability.
Automated checks on commit fdf5fbd, 2 Nov 2026. Not an audit.

## Links

- Documentation: https://pushbits.github.io/
- Unraid: https://ca.unraid.net/apps/pushbits-1nipg2k0rqrpjs?q=PushBits
- Official website: https://pushbits.github.io/
- GitHub: https://github.com/pushbits/server

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/289/pushbits), the self-hosted and open-source app directory.
