Map Your Homelab

Lightweight inventory, rack and topology tool for homelabbers. Track hardware, VMs, LXCs, apps and networks -self-hosted with Docker.

⚠️ Demo saves in your browser only. Self-host for persistent shared storage.

Labby topology dashboard

Everything for your homelab map

One dashboard for all your infrastructure. From bare-metal servers to containerized apps -add it, connect it, visualize it and style it with the new theme customizer.

🖥️

Resource Tracking

Hardware, VMs, LXCs, Apps and Networks with rich metadata -OS, CPU, RAM, disks, notes and links.

🌳

Topology Views

Tree view and interactive Graph view visualize hosting relationships between every resource.

🗄️

Rack Editor

Create locations and racks. Drag components into front and rear rack slots and link them to Labby resources.

🌐

IP View

Dedicated IP address view grouped by subnet. Live search by IP, hostname or port. Color-coded networks.

📡

Live Status Checks

Optional auto-ping for IPs and auto-check for URLs. Online / Offline / Maintenance status per resource.

⌨️

Browser Console

Open SSH sessions with password or SSH private-key credentials, auto-copy selected terminal text and clear known-host keys per target.

🤖

Agent API Keys

Create scoped, time-limited API keys for trusted agents with inventory, rack, status, ping and credential permissions.

🔐

Saved Credentials

Store editable usernames, passwords, SSH private keys and passphrases for Hardware, VMs, LXCs and Apps, then mark them for Web or CLI access.

🧩

Encrypted Import / Export

Backups include resources, racks, themes and, when present, encrypted credentials plus encrypted API key records protected by a one-time export key.

🎨

10+ Themes

Built-in Light, Dark, Ocean, Nord, Grape and more -plus the new custom theme editor with filled color circles, desktop descriptions and export support.

💾

Server-Side Storage

Data lives on the server, shared across all browsers and devices. Export / import JSON backups anytime.

📱

Mobile Optimized

Full-screen views and bottom navigation on mobile and tablet. Same features, smaller screen.


Open SSH sessions from your topology

Resources with CLI credentials can expose a secure console button next to their IP address. Labby opens the session in a designed terminal window on desktop and a full mobile console page on phones.

CLI access without leaving Labby

Store password or SSH private-key credentials on Hardware, VMs, LXCs or Apps, mark them for CLI access, and connect by clicking the terminal icon in Topology. Terminal output can be copied, selected text auto-copies, and known-host keys can be cleared for a specific target.

  • Password or SSH private-key authentication per resource
  • Desktop console window with black terminal surface
  • Mobile full-page console with bottom navigation preserved
  • Clear SSH known-host key for the current target
Labby browser console
Browser console for resource CLI access

Connect trusted agents with API keys

Labby can expose scoped API access for automation agents such as Hermes, OpenClaw or your own monitoring scripts. Agents can read inventory, update status, trigger allowed ping checks and, when explicitly allowed, read or update resource credentials.

Scoped keys for automation

Create time-limited API keys from Config → API Keys. Each key receives only the permissions it needs, and the token is shown once for secure copy-and-paste into your agent configuration.

  • Read inventory, locations and racks
  • Write inventory and rack updates only when explicitly allowed
  • Submit live status updates from external monitoring agents
  • Run ping checks with scoped permission
  • Restore encrypted API key records through config import when the export key is provided
Labby API key management
API key management with scopes and expiration

See it in action


Up in two commands

Requires Docker and Docker Compose. Data is stored in a named Docker volume and survives restarts.

1

Clone the repository from GitHub

2

Run docker compose up

3

Open localhost:8080

git clone https://github.com/techbygiusi/Labby.git
cd Labby
docker compose up --build -d

🧪

Ready to map your homelab?

Try the live demo instantly -no sign-up needed. Or self-host Labby for persistent shared storage across all your devices.