Krowa-Admin

===== SYSTEM =====
Uptime: up 12 days, 4 hours, 18 minutes
Load average: 0.42 / 0.36 / 0.31
Load per CPU (1 min): 0.11 (4 CPUs)
Memory: 2.8 GiB / 7.8 GiB (36% used)
Available: 4.7 GiB
Disk /: 18.4 GiB / 58.2 GiB (32% used)
Available: 36.8 GiB

===== SERVICES =====
docker: ✔ running
ssh: ✔ running
k3s: ✔ running

===== DOCKER CONTAINER STATUS =====
example-frontend: ✔ running
example-backend: ✔ running

===== K3S CLUSTER STATUS =====
Nodes:
raspberrypi   Ready   control-plane,master   235d   v1.31.5+k3s1
Running Pods: 24

✔ K3s token exists and matches backup

🐮 What is Krowa-Admin?

Krowa-Admin is a lightweight, configurable server status report for Linux systems. It reports system resource usage, checks systemd services, expected Docker containers, and—optionally—selected K3s cluster resources. Each host can enable only the checks it needs in its own YAML file, so the same installation works across Raspberry Pi devices, VPS instances, and other servers.

Run a fresh report with the krowa-admin command. Package installations can also display it automatically in interactive login sessions.

“Not another bloated DevOps suite—just a focused cow for focused work.” 😄

🚀 Key features

  • configurable systemd service checks,
  • optional uptime, load average, memory, active swap, and disk usage reports,
  • detection of missing, stopped, and unhealthy Docker containers,
  • optional K3s node, pod, and namespace reports,
  • optional K3s token validation against a local backup,
  • clear, colored terminal output,
  • host configuration in /etc/krowa-admin/config.yaml, preserved during upgrades,
  • native DEB and RPM packages.

All checks are disabled in the example configuration by default. Administrators explicitly enable only the checks required by each host.

📦 Installation

Download the appropriate package from the latest GitHub release.

Debian, Raspberry Pi OS, and related distributions:

sudo apt-get install ./krowa-admin_*_all.deb

Fedora and related RPM-based distributions:

sudo dnf install ./krowa-admin-*.noarch.rpm

Docker and kubectl are optional and are needed only when their corresponding checks are enabled.

🔗 Project

The source code, complete configuration guide, and package build instructions are available at github.com/shiver25/krowa-admin. The project is released under the MIT License.