https://github.com/Timmoth/RackPeek
CLI tool to discover, manage, and document your IT infrastructure and home lab.
https://github.com/Timmoth/RackPeek
cli home-lab infrastructure inventory networking self-hosted
Last synced: about 1 month ago
JSON representation
CLI tool to discover, manage, and document your IT infrastructure and home lab.
- Host: GitHub
- URL: https://github.com/Timmoth/RackPeek
- Owner: Timmoth
- License: agpl-3.0
- Created: 2026-01-24T16:39:00.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-07T20:50:10.000Z (about 2 months ago)
- Last Synced: 2026-03-08T00:57:51.963Z (about 2 months ago)
- Topics: cli, home-lab, infrastructure, inventory, networking, self-hosted
- Language: C#
- Homepage: http://timmoth.github.io/RackPeek/
- Size: 6.87 MB
- Stars: 1,009
- Watchers: 7
- Forks: 30
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](./assets/rackpeek_banner_thin.png)
 
[](https://discord.gg/egXRPdesee) [](https://timmoth.github.io/RackPeek/) [](https://hub.docker.com/r/aptacode/rackpeek/)
RackPeek is a webui & 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 or drowning in unnecessary metadata or process.
### The roadmap for the next wave of features is actively being discussed, please make your voice heard!
[](https://www.youtube.com/watch?v=RJtMO8kIsqU)
[![Brandon Lee — I’m Documenting My Entire Home Lab as Code \[video\]](https://img.shields.io/badge/Brandon%20Lee%20\[video\]-I%E2%80%99m%20Documenting%20My%20Entire%20Home%20Lab%20as%20Code-blue?style=for-the-badge)](https://www.youtube.com/watch?v=wY1DgT3GD6U)
[](https://www.virtualizationhowto.com/2026/02/im-documenting-my-entire-home-lab-as-code-with-rackpeek/)
[](https://jaredheinrichs.substack.com/p/how-to-document-your-entire-homelab)
[](./rpk-demo.gif)
[](./rpk-webui-demo.gif)
## Running RackPeek with Docker
```text
# Named volume
docker volume create rackpeek-config
docker run -d \
--name rackpeek \
-p 8080:8080 \
-v rackpeek-config:/app/config \
aptacode/rackpeek:latest
# Bind mount
docker run -d \
--name rackpeek \
-p 8080:8080 \
-v $(pwd)/config:/app/config \
aptacode/rackpeek:latest
# Note - RackPeek stores its state in YAML
config/
└── config.yaml
```
Or Docker compose
```yaml
version: "3.9"
services:
rackpeek:
image: aptacode/rackpeek:latest
container_name: rackpeek
ports:
- "8080:8080"
volumes:
- rackpeek-config:/app/config
restart: unless-stopped
volumes:
rackpeek-config:
```
## Docs
*
[**Overview**](https://timmoth.github.io/RackPeek/docs/overview)
*
[**Installation Guide**](https://timmoth.github.io/RackPeek/docs/install-guide)
*
[**Ansible Inventory Generator Guide**](https://timmoth.github.io/RackPeek/docs/ansible-generator-guide)
*
[**CLI Commands Reference**](https://timmoth.github.io/RackPeek/docs/cli-commands)
*
[**Versioning**](https://timmoth.github.io/RackPeek/docs/versioning)
## Questionnaire
We’re gathering feedback from homelabbers to validate direction and prioritize features.
Answer whichever questions stand out to you, your input directly shapes the project.
[](https://forms.gle/KKA4bqfGAeRYvGxT6)
## 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.
## Development Docs
* [`contribution-guidelines.md`](docs/development/contribution-guidelines.md) – How to propose changes and submit PRs
* [`dev-cheat-sheet.md`](docs/development/dev-cheat-sheet.md) – Build, release, Docker, and testing commands
* [`testing-guidelines.md`](docs/development/testing-guidelines.md) – Testing principles and standards