RackMarshal 1.0 · Open Source · Local First

Know what changed.
Know what failed.
Know when it recovered.

Local-first infrastructure operations and incident management for self-hosted systems. RackMarshal records durable operational state, detects and tracks incidents, and verifies recovery.

Get RackMarshal 1.0View on GitHub
RackMarshal 1.0 is the first stable release.
Beyond dashboards

Monitoring tells you what is happening now. RackMarshal remembers what happened.

RackMarshal maintains operational state across time: observations become evidence, meaningful changes become events, failures become incidents, and recovery is tracked instead of assumed.

Observe State
Detect Divergence
Manage Incidents
Track Recovery
Preserve Evidence
What exists today

Operational domains in RackMarshal 1.0

The current codebase contains operational domains for the following infrastructure. RackMarshal stores observations, events, incidents, cycle health and related state locally in SQLite.

Virtualization

Proxmox VE

Resource and infrastructure observations.

Storage

ZFS

Storage and pool health observations.

Backup

Backup / PBS

Backup observations and operational state.

Automation

Home Assistant

Home Assistant observations.

Systems

Hardware health

Infrastructure hardware health observations.

Availability

Mounts

Mount availability and state.

Designed for infrastructure you control

Local first by design.

RackMarshal is designed to operate without turning your infrastructure telemetry into a dependency on somebody else's hosted service.

Local operationRun RackMarshal on infrastructure you control.
Durable operational historyPreserve state instead of relying only on transient alerts.
Evidence-based incidentsTrack observations and events associated with failure and recovery.
Configuration-driven monitoringDefine how RackMarshal interacts with your environment.
Reproducible deploymentInstallation, configuration and database migrations are designed to be repeatable.
Minimal external dependenciesCore operation does not depend on a hosted monitoring service.

Built in a real environment, not just designed on paper.

RackMarshal grew from a working homelab operations system and the need to understand Proxmox, ZFS, backups, Linux infrastructure, hardware and other systems as a whole.

RackMarshal 1.0 turns that system into a reproducible open-source platform for homelabs, self-hosted infrastructure, edge systems and small infrastructure environments.

Early adopters wanted

Put RackMarshal into infrastructure we did not build.

We are looking for technically experienced users willing to install RackMarshal, configure it against real systems, challenge its assumptions and find the environments we did not anticipate.

ProxmoxZFSLinuxPBSHome AssistantSelf-hosted infrastructure
Installation GuideGitHubReport an Issue
Important current boundary

A successful base installation proves the RackMarshal runtime, database, status API and notification queue can run. It does not automatically configure access to Proxmox, PBS, Home Assistant, ZFS, hardware or mount targets.

Those integrations require site-specific configuration and credentials. The installer does not copy production credentials or discover your infrastructure automatically.