RackPeek

RackPeek

RackPeek is a lightweight, opinionated CLI tool for documenting and managing home lab and small-scale IT infrastructure.

It helps you track hardware, services, networks, and their relationships in a clear, scriptable, and reusable way without enterprise bloat or proprietary lock-in.

RackPeek is open source and community-driven. Code, docs, ideas, bug reports, and real-world usage feedback are all massively appreciated. If you run a home lab, you belong here.

Philosophy

RackPeek treats infrastructure documentation as living reference data rather than static paperwork.

You should be able to document your environment as you build it, explore relationships between systems, and quickly understand how everything fits together, without drowning in unnecessary metadata or process.

RackPeek is not a CMDB replacement. It’s a clean framework for understanding and maintaining your lab.

Core Values

Simplicity
RackPeek focuses on clarity and usefulness. Its scope is intentionally kept narrow to avoid unnecessary abstraction and feature creep.

Ease of Deployment
The tool exists to reduce operational complexity. Installation, upgrades, and day-to-day usage should be straightforward and low-friction.

Openness
RackPeek uses open, non-proprietary data formats. You fully own your data and should be free to easily inspect, migrate, or reuse it however you choose.

Community
Contributors of all experience levels are welcome. Knowledge sharing, mentorship, and collaboration are core to the project’s culture.

Privacy & Security
No telemetry, no ads, no tracking, and no artificial restrictions. What runs on your infrastructure stays on your infrastructure.

Dogfooding
RackPeek is built to solve real problems we actively have. If a feature isn’t useful in practice, it doesn’t belong.

Opinionated
The project is optimized for home labs and self-hosted environments, not enterprise CMDBs or corporate documentation workflows.

Release Status

[x] Ideation
[~] Development
[ ] Alpha Release
[ ] Beta Release
[ ] v1.0.0 Release

Command Tree

• rpk
  • summary - Show a summarized report for all resources
  • servers - Manage servers
  • summary - Show a summarized hardware report for all servers
  • add - Add a new server
  • get - List servers or get a server by name
  • describe - Show detailed information about a server
  • set - Update server properties
  • del - Delete a server
  • tree - Displays a dependency tree for the server
  • cpu - Manage server CPUs
    • add - Add a CPU to a server
    • set - Update a CPU on a server
    • del - Remove a CPU from a server
  • drive - Manage server drives
    • add - Add a drive to a server
    • set - Update a drive on a server
    • del - Remove a drive from a server
  • gpu - Manage server GPUs
    • add - Add a GPU to a server
    • set - Update a GPU on a server
    • del - Remove a GPU from a server
  • nic - Manage server NICs
    • add - Add a NIC to a server
    • set - Update a NIC on a server
    • del - Remove a NIC from a server
  • switches - Manage switches
  • summary - Show switch hardware report
  • add - Add a new switch
  • list - List switches
  • get - Get a switches by name
  • describe - Show detailed information about a switch
  • set - Update switch properties
  • del - Delete a switch
  • systems - Manage systems
  • summary - Show system report
  • add - Add a new system
  • list - List systems
  • get - Get a system by name
  • describe - Show detailed information about a system
  • set - Update system properties
  • del - Delete a system
  • tree - Displays a dependency tree for the system
  • accesspoints - Manage access points
  • summary - Show access point hardware report
  • add - Add a new access point
  • list - List access points
  • get - Get an access point by name
  • describe - Show detailed information about an access point
  • set - Update access point properties
  • del - Delete an access point
  • ups - Manage UPS units
  • summary - Show UPS hardware report
  • add - Add a new UPS
  • list - List UPS units
  • get - Get a UPS by name
  • describe - Show detailed information about a UPS
  • set - Update UPS properties
  • del - Delete a UPS
  • desktops - Manage Desktops
  • add
  • list
  • get
  • describe
  • set
  • del
  • summary - Show desktop hardware report
  • tree
  • cpu
    • add
    • set
    • del
  • drive
    • add
    • set
    • del
  • gpu
    • add
    • set
    • del
  • nic
    • add
    • set
    • del
  • services - Manage services
  • summary - Show service summary report
  • add - Add a new service
  • list - List all services
  • get - Get a service by name
  • describe - Show detailed information about a service
  • set - Update service properties
  • del - Delete a service
  • subnets - List service subnets or filter by CIDR