Repolode
Submit
Timmoth

Timmoth/RackPeek

A web UI and CLI for documenting and managing home lab and small-scale IT infrastructure, stored in YAML files.

Open-source alternative to:NetBox

View on GitHubWebsite
Stars
1,820
Forks
92
Open issues
54
Last commit
9 days ago

What is it?

RackPeek is a web UI and command-line tool for tracking hardware, services, networks, and the relationships between them in a home lab or small IT setup. It is aimed at people who want a lightweight inventory they can script and reuse, rather than enterprise CMDB software.

State is stored in YAML under a config directory, so the data stays in an open, human-readable format that can be inspected, migrated, or edited directly. The project is distributed as a Docker image and a Docker Compose setup that exposes the web app on port 8080, and it includes a health endpoint for container checks.

The project provides a CLI command reference and an Ansible inventory generator guide, which suggests the stored inventory can feed automation workflows. It is licensed under AGPL-3.0 and ships a live online demo.

Key features

  • 01Track hardware, services, and networks and the links between them.
  • 02Use either the web UI or the command-line interface.
  • 03Store all data in plain YAML files under a config directory.
  • 04Run as a Docker container or with Docker Compose on port 8080.
  • 05Generate Ansible inventory from the stored data.

Use cases

  • Documenting a home lab's servers, VMs, and network devices in one place.
  • Keeping a scriptable inventory that automation tools can consume.
  • Maintaining a small self-hosted IT inventory without enterprise software.

Quick start

  1. 1

    Create the named volume for config storage

    docker volume create rackpeek-config
  2. 2

    Run the RackPeek container and open port 8080

    docker run -d --name rackpeek -p 8080:8080 -v rackpeek-config:/app/config aptacode/rackpeek:latest

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires sharing source code for modified versions offered over a network.
  • Its scope is intentionally narrow and opinionated for home labs and self-hosted setups, not enterprise CMDB use.

Topics

#home-lab#infrastructure#inventory#self-hosted#cli#networking#docker

FAQ

What is RackPeek?
A web UI and CLI for documenting and managing home lab and small-scale IT infrastructure, stored in YAML files. RackPeek is a web UI and command-line tool for tracking hardware, services, networks, and the relationships between them in a home lab or small IT setup. It is aimed at people who want a lightweight inventory they can script and reuse, rather than enterprise CMDB software.
Is RackPeek free to use? What license does it have?
RackPeek is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is RackPeek still maintained?
Actively maintained. The last commit to RackPeek was on Oct 11, 2026.
What can I use RackPeek for?
Documenting a home lab's servers, VMs, and network devices in one place. Keeping a scriptable inventory that automation tools can consume. Maintaining a small self-hosted IT inventory without enterprise software.
How do I install RackPeek?
Create the named volume for config storage: docker volume create rackpeek-config Run the RackPeek container and open port 8080: docker run -d --name rackpeek -p 8080:8080 -v rackpeek-config:/app/config aptacode/rackpeek:latest
Where can I get RackPeek?
The source code and installation instructions are on GitHub: https://github.com/Timmoth/RackPeek

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects