Runitor
Runitor is a command-line tool that runs a specified command and reports success or failure to a Healthchecks-compatible endpoint based on the process exit…
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.
64/100 Good
- Maintained
- 72last commit 53 days ago
- Popular
- 51362 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 92no serious findings, CI, tests, OpenSSF Scorecard 7.9/10
Based on 4 of 5 factors.
Availability: platform listings confirmed today, links checked 55 days ago
- GitHub stars
- 362
- Open issues
- 8
- Last commit
- 2026-09-29
- Latest release
- v1.4.1-build.6
- License
- 0BSD
- Activity
- stale
Checked 21 days ago - source: GitHub (bdd/runitor)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Install the runitor binary with Go Run `go install bdd.fi/x/runitor/cmd/runitor@latest` with Go 1.19 or newer. This puts the `runitor` command in `$GOPATH/bin` or `$HOME/go/bin`, so if that folder isn’t in your PATH, the command won’t be found when you try to start it. source
- Set the Healthchecks base URL and handle Before starting a monitored process, provide the API base URL and check handle (the UUID or pingKey/slug that identifies your check). Without these, Runitor has no place to send the start/end pings, so Healthchecks won’t know the job ran. source
- Use a valid cron expression if scheduling If you want scheduled runs, write a cron expression like `0 02,14 * * *` for 2 a.m. and 2 p.m. daily. An invalid expression causes an error and means the next run time won’t be scheduled. source
Fetched 54 days ago - each note links to its source
Variants
Alternatives (12)
- C (programming language)
- C#
- C++
- Crystal (programming language) - Programming language with Ruby-like syntax that compiles to efficient native code.
- Dart - Dart is a general-purpose, strongly typed programming language that compiles to native machine code, JavaScript, or WebAssembly.
- Java - Java is a general-purpose computer programming language that is concurrent, class-based, object-oriented, and specifically designed to have…
- Lua - Lua is a powerful, fast, lightweight, embeddable scripting language.
- Nim (programming language) - Nim is a statically typed, imperative programming language with a powerful macro system that tries to give the programmer ultimate power wi…
- Perl - Perl is a high-level, general-purpose, interpreted, dynamic programming language used for system administration, web development, network p…
- Python - This container needs special attention.
- Rust
- Swift (programming language)
Checked 41 days ago - source: AlternativeTo
Common questions
How do I install Runitor so cron can find the command?
Install it with Go 1.19 or newer using the latest runitor command module. Go places the binary in $GOPATH/bin or $HOME/go/bin, so add that directory to PATH or use the full binary path in cron.
What Healthchecks values must Runitor receive before starting a command?
Provide the API base URL and the check handle, such as the UUID, pingKey, or slug. Without those, Runitor has no endpoint to send the start and end pings.
How does Runitor decide whether the monitored command succeeded?
It runs the supplied command and captures its output. It reports successful or failed execution to Healthchecks based on the process exit code.
Can Runitor be used to monitor internal web servers from cron?
A self-hoster suggested using it in cron jobs to monitor web servers. Runitor sends success or failure to Healthchecks, which can cover internal services.
Answers sourced from github.com, github.com, github.com, www.reddit.com
Community
- r/selfhosted on Reddit: Looking for self-hosted options like ... (reddit)
- Best Server Monitoring software : r/selfhosted - Reddit (reddit)
- Docker appliance recommendations? : r/selfhosted - Reddit (reddit)
Collected 48 days ago - public community threads