Free-to-use, self-hosted 3D digital-twin DCIM. Model your room in 3D, track cabinets, devices, ports, and cabling, and drive a live thermal heatmap from your own telemetry.
Website · Documentation · Quick start · Deployment · License
RackDaddy Lab runs as a single self-contained Docker stack you can stand up in a couple of minutes. It is free to use, but for now it is not open source: modifying, forking, or redistributing it requires prior written permission (see License). Open-sourcing RackDaddy Lab is planned for a future release. More advanced capabilities are in beta or on the roadmap (see Roadmap).
Visualise
- Top-down overview and a real-time 3D scene of your room
- Live thermal heatmap driven by your telemetry, plus an auto-rotating slideshow mode
Inventory
- Cabinets, devices, and a bundled device-type library (thousands of types, ready to use with no import) with front/rear images (generated placeholder schematics when a type has no photo, plus a one-click Download real images in Rack Manager to install the optional real-photo pack)
- Ports, and a Rack Manager for placing and moving equipment U by U
Connectivity
- Connections and structured cabling, cable runs, and a connection inspector
Power (basic)
- A power dashboard (manual and allocated draw) and distribution-board breaker mapping
Live monitoring (generic)
- Bind your own InfluxDB, SNMP, or Modbus source under Data Sources and watch the 3D heatmap and power figures update live. Nothing is hardcoded to any one vendor. See MONITORING.md for a from-scratch InfluxDB + Telegraf walkthrough.
Planning and ops
- Capacity ("will it fit") checks, local user accounts, ntfy notifications, background jobs, and per-site 3D scene (GLB) upload
Setup
- A visual Site Configurator (floor designer) and a Configuration section, all in the browser
Install anywhere
- RackDaddy Lab is an installable Progressive Web App (PWA): add it to your desktop or phone home screen and run it in its own window, with a touch-friendly mobile layout and an offline-cached UI
RackDaddy Lab also includes a capped taste of IPAM: up to two prefixes, with on-demand IP sweep / auto-discovery to reconcile live hosts (VLANs included).
Lab runs one site, a 2 x 2 floor (two rows of two cabinets), and two IPAM prefixes. Larger deployments and the more advanced modules are in beta and on the roadmap (see Roadmap).
You need Docker with the Compose plugin. Then:
git clone https://github.com/RackDaddyDCIM/RackDaddy-Lab.git
cd RackDaddy-Lab
docker compose -f docker-compose.lab.yml up -d --buildOpen http://localhost:8080 and sign in with the bootstrap admin:
- username:
admin - password:
rackdaddy
The database schema is created automatically on first boot. You start on an empty site: open Site Configurator to design your floor, then Rack Manager to place devices. Change the admin password before putting this on a network (see DEPLOYMENT.md).
New here? The wiki has an illustrated Quick-Start and a live-monitoring walkthrough.
Three containers, one exposed port:
| Service | Stack | Role |
|---|---|---|
postgres |
PostgreSQL 16 | Application database (one volume, survives rebuilds) |
api |
Node.js, Express, Prisma | REST API + WebSocket live updates on port 3002 (internal) |
frontend |
React, Vite, nginx | Serves the built UI and reverse-proxies /api + /ws to api |
Only the frontend is published (default 8080:80). On first boot the API runs
prisma db push to create the schema, so there is no separate migration step. State
that must persist beyond the database (local users, uploads, the site registry) lives
on named Docker volumes.
Everything can be set in the UI (Site Configurator, Data Sources, Configuration) or through environment variables passed to the compose file. The common ones:
| Variable | Default | Purpose |
|---|---|---|
LAB_PORT |
8080 |
Host port for the web UI |
DB_PASSWORD |
change_me_in_production |
PostgreSQL password |
APP_NAME |
RackDaddy |
Product name shown in the UI |
SITE_NAME |
Lab |
Display name of the single site |
LOCAL_AUTH_USER |
admin |
Bootstrap admin username |
LOCAL_AUTH_PASSWORD_HASH |
(baked "rackdaddy") | scrypt hash of the admin password |
LOCAL_AUTH_SECRET |
(placeholder) | HS256 signing secret for sessions |
INFLUX_URL / INFLUX_TOKEN / INFLUX_ORG |
unset | Optional live-monitoring source |
See .env.example for the full list and
DEPLOYMENT.md for how to set them safely.
RackDaddy Lab ships the full modeling and live-monitoring core today. These capabilities are in beta or on the roadmap:
Beta
- Auto-discovery and scheduled network rescan
- Work orders and audit trail
- Reporting and PUE
- Service-account API tokens and OpenAPI docs
- IPAM and VLANs beyond two prefixes
- Custom fields
Roadmap
- Multi-site and larger floors
- Tenant / colo portal
- Vendor HVAC, power, and genset drivers
- Single sign-on (OIDC)
Contributions and feedback are welcome. Because RackDaddy Lab is not open source, please open an issue to discuss a change before starting work. By submitting a contribution you agree it may be incorporated into the Software under the project License, and that the copyright holder retains ownership.
RackDaddy Lab is free to use: you may download, install, and run it at no charge, including for commercial purposes. You may not modify, fork, reverse-engineer, redistribute, or create derivative works without prior written permission from the copyright holder. All rights reserved. See LICENSE for the full terms.
Future direction. For now, RackDaddy Lab stays as it is under the terms above. A future release is planned to move RackDaddy Lab to an open-source license. Until then, these terms apply.

