RackPeek

RackPeek is a self-hosted CLI and web app for documenting home labs and small IT environments. Track hardware, systems, services, and connections in a portable YAML inventory. Use the CLI or web app to manage it, discover existing infrastructure, and export data for tools such as Ansible.

Quick start

Run RackPeek with a persistent Docker volume:

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

Open http://localhost:8080. RackPeek stores its inventory in config.yaml inside the volume. For bind mounts, the host directory must be writable by container user 1654; add :Z on SELinux systems.

Mobile app

The iOS and Android app supports local inventory editing and syncs with a RackPeek server when connected. The app is in early access; join the Discord for updates and testing information.

Documentation

• Overview
• Installation
• CLI reference
• Discovery
• Inventory API
• MCP server
• Ansible inventory

Development

See the developer setup, testing guide, and contribution guide. The release process is in release-guide.md.