Shoutrrr
Shoutrrr is a command-line notification tool that sends messages to many services from scripts, containers, or home-lab automation.
Platform availability
Available on 1 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 (not listed)
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.
56/100 Fair
- Maintained
- 53last commit 196 days ago
- Popular
- 651,715 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 73no serious findings, 1 minor, CI, tests, OpenSSF Scorecard 4.2/10
Based on 4 of 5 factors.
Availability: platform listings confirmed today, links checked 45 days ago
- GitHub stars
- 1,715
- Open issues
- 81
- Last commit
- 2026-05-09
- Latest release
- v0.8.0
- License
- MIT
- Activity
- stale
Checked 12 days ago - source: GitHub (containrrr/shoutrrr)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Install the prebuilt binary Use the docs' release download steps to get a ready-to-run shoutrrr program instead of building it from raw code. This avoids having to install the Go programming language first, which most first-time users don't need. source
- Keep go/bin in PATH After install, add the go/bin folder in your user profile to your PATH (the list of folders your terminal searches for commands). If it isn't, the terminal will say shoutrrr is not found even though the file is installed. source
- Skip contributor extras The Make (a build tool), MkDocs (a documentation site builder), and Python setup steps are for contributor tools like building docs, not for a normal install. Skip them unless you specifically want to work on the project's documentation site. source
- Container setup Shoutrrr is a CLI tool, so add your command arguments to the container's Post Arguments field. source
- Install with snap or Go Official package installs: sudo snap install shoutrrr or go install github.com/containrrr/shoutrrr/shoutrrr@latest source
Fetched 2 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Do first-time users need to install Go to run Shoutrrr?
No, you can use the prebuilt binary from the docs' release download steps. Add the go/bin folder to your PATH or the terminal will not find the shoutrrr command.
Do I need the Make, MkDocs, and Python setup steps to use Shoutrrr normally?
No, those steps are for contributor tooling and building the documentation site. Skip them unless you want to work on the project's documentation.
Can I run Shoutrrr in Docker instead of only in CLI mode?
Yes, the getting-started docs say you can run your own Shoutrrr instance with Docker in a few minutes.
What notification issue have users reported with Watchtower and Shoutrrr in Docker?
A user reported that Watchtower notifications sent through Shoutrrr to Discord stopped being as useful as before.
Answers sourced from github.com, github.com, shoutrrr.com, www.reddit.com
Community
- Help setting up Shoutrrr : r/selfhosted - Reddit (reddit)
- Watchtower shoutrrr notifications now using container ... - Reddit (reddit)
- Getting Shoutrrr to Work in Docker : r/selfhosted - Reddit (reddit)
Collected 53 days ago - public community threads