Visitar URL original
GitHub - RackDaddyDCIM/RackDaddy-Lab: 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. · GitHub
Skip to content

About

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.

Topics

Resources

Stars

39 stars

Watchers

1 watching

Forks

Repository files navigation

RackDaddy

RackDaddy Lab

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.

License: free to use  Release  Self-hosted  Docker Compose

Website  ·  Documentation  ·  Quick start  ·  Deployment  ·  License


RackDaddy Lab - live thermal heatmap over the 3D floor

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).

What you get

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).

Rack Manager   Power dashboard

Rack Manager (left) and the power dashboard (right), both driven by live demo telemetry.


Quick start

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 --build

Open 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.


Architecture

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.


Configuration

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.


Roadmap

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)

Contributing

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.

License

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.

About

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.

Topics

Resources

Stars

39 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages