Know what's lurking in your lab.

Local-first homelab inventory

LabRat reads what your network and hypervisors already know, then lets you place every device in a real location, area, and rack. Nothing moves until you say so.

  • UniFi Network
  • Proxmox VE
  • NUT UPS servers
  • MikroTik MNDP

See your lab the way it is cabled

Racks to scale. Front and rear, real port lamps, and the cables between the ports they use.
Wiring you can read. Each area left to right from the internet; select a server to light its route.
Your cluster, drive by drive. Proxmox nodes, guests, storage, and Ceph.
A wallboard for the closet. Internet, UPS power, ports, and what needs a look.
Every client, and where it connects. Wired and Wi-Fi, port by port.
Mini racks too. A 10-inch rack at the same scale as its neighbors.
Discovery, as a tree. Routers, switches by hop, and what hangs from them; place anything in a click.
The cluster at a glance. Nodes, guests, CPU, memory, storage, and Ceph, with what needs attention.
Networks, from UniFi. Site health, VLANs, Wi-Fi, firewall zones, and who can reach whom.
Floor plans. Racks, shelves, walls, and floor, top down, for every room.

Every screenshot is from an invented demo lab.

Read-only by design

It only reads

The collector never changes a controller's settings, logs in to a device to change it, or sends a UPS a command.

It stays in bounds

It contacts the controllers you connect and, beyond them, only the networks you allow in Settings.

Secrets stay put

Credentials live in a local config file, never in the database.

You decide where things go

What a scan finds stays separate from your inventory until you place it or link it.

What it reads

SourceWhat LabRat getsWhat it needs
UniFi NetworkSwitches, gateways, access points; ports, PoE, link state, and cables; clients, networks, Wi-Fi, firewall zones; WAN and VPN statusA read-only API key
Proxmox VENodes, NICs, bonds, bridges, VLANs; guests; storage, drives, and Ceph; live load and memoryA read-only API token
Pi-holeQueries, blocking state, history, and top domains and clientsAn application password
Network UPS ToolsUPS status, load, battery, and runtimePermission to scan their networks
SNMPv3NIC link state for Proxmox nodesA read-only SNMPv3 user
MikroTik MNDPMikroTik devices on the local segmentNothing: it only listens

Quick start

With Docker and Compose:

git clone https://github.com/dlenwell/labrat labrat && cd labrat
mkdir -p deploy/data deploy/config
export LABRAT_UID=$(id -u) LABRAT_GID=$(id -g)
LABRAT_ALLOWED_HOSTS=labrat.example.lan \
  docker compose -f deploy/compose.yaml up -d --build
docker compose -f deploy/compose.yaml logs web | grep "setup code"

Open http://<host>:8000, choose First-time setup, enter the code from the log, then connect your controllers under Settings → Integrations. The setup guide covers running from a checkout, HTTPS, and upgrades.