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…

  • Automation
  • Monitoring & Logging
  • Other
  • Productivity
  • Tools & Utilities
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 code. It lets self-hosters monitor short-lived jobs, scheduled tasks, and internal services that do not expose a built-in health endpoint. Use it when you want simple command completion pings instead of writing a custom wrapper.

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

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

Collected 48 days ago - public community threads