feat/container-details
Container details now carry the image id and the HostConfig resource limits
(CPU cores and shares, memory and swap bytes, pids, device requests) plus sandbox flags
(privileged, read-only rootfs, network mode, restart policy), with null meaning unlimited. A new
GET /api/v1/docker/containers/{name}/stats returns one live sample: CPU percent
of one core, memory working set, processes, block IO and network bytes. Peers
proxy the new route.
Env, labels, command lines and mounts are deliberately excluded from the payload.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
skyg-linux-tracker
A small, read-only monitor for a Linux host. One binary, slinuxm, tells you what systemd, the journal and Docker are doing, through:
- a REST API (JSON, with Server-Sent Events for live logs),
- an MCP server so AI agents can inspect the host,
- optional OpenTelemetry export of metrics and logs.
It reads everything live, keeps no data of its own beyond a database of hashed API tokens, and cannot start, stop or change anything on the host.
Try it in a minute
No root, no install. The token database goes in a temp directory.
cargo build --release # needs Rust, pkg-config, lld, libsystemd headers (or: devenv shell)
export SKYG_AUTH__DB_PATH=/tmp/slinuxm-demo/db.sqlite
BIN=target/release/slinuxm
TOKEN=$($BIN token create demo) # printed once, stored only as a hash
$BIN serve & # http://127.0.0.1:1984, loopback only
curl -s http://127.0.0.1:1984/healthz
curl -s -H "Authorization: Bearer $TOKEN" 'http://127.0.0.1:1984/api/v1/systemd/units?state=failed'
curl -s -H "Authorization: Bearer $TOKEN" 'http://127.0.0.1:1984/api/v1/journal?priority=err&lines=20'
kill %1
Or with Nix: nix run git+ssh://gitea@gitea.app.internal/Hermenix/skyg-linux-tracker -- --help.
Documentation
Read in this order:
| Guide | What it covers |
|---|---|
| How it works | What the binary does when it runs, what it reads, auth, signals, every command |
| Install | Nix and NixOS module, or from source with an example systemd unit |
| Configuration | Config file, environment variables, CLI flags, every section |
| Operations | Tokens, MCP clients, network exposure, Docker access, OpenTelemetry, troubleshooting |
Reference:
| Doc | What it covers |
|---|---|
| API reference | Every REST route and MCP tool; also served by the binary at /docs |
| TLS | HTTPS, certificate rotation, ACME |
| Consolidator | One instance watching others (peers) |
config.example.toml |
Every config key with its default |
| Development | Building, tests, git hooks, version stamp |
| ARCHITECTURE.md | Internals and design decisions |
At a glance
| Binary | slinuxm (Linux, links libsystemd; no openssl) |
| Listens on | 127.0.0.1:1984 by default |
| Config | /etc/skyg-linux-tracker.toml, SKYG_* env vars, CLI flags |
| State | /var/lib/skyg-linux-tracker/db.sqlite (hashed tokens only) |
| Auth | Bearer tokens, slinuxm token create <name> as the service user |
| Sources | systemd over D-Bus, the journal via libsystemd, Docker over its unix socket |
Languages
Rust
86.7%
Nix
6.8%
Nushell
4.5%
Shell
1.4%
JavaScript
0.3%
Other
0.3%