Skip to content

health

Check system health.

Usage

sh
mithrandir health

Description

Runs a series of health checks:

  • Docker — daemon is running
  • Disk space — app data and backup directories have sufficient space
  • Backup age — backups are recent (not stale)
  • Container restarts — no containers in restart loops
  • Remote backup — rclone remote is reachable

Each check reports pass/warn/fail status.

Exit Code

Returns exit code 1 if any check fails, 0 if all pass. Useful for monitoring scripts.

Non-TTY Mode

Outputs plaintext results when run in a non-interactive shell.

Notes

  • Requires root privileges