RackulaLives/Rackula

Drag-and-drop rack layout designer
Plan your rack, move some pixels, save your shoulders.

• Drag and drop devices into your rack from a real hardware library
• Real device images from the NetBox devicetype-library, not grey boxes
• Export layouts to PNG, PDF, or SVG for documentation and change requests
• Share layouts via URL or QR code, no file attachments needed
• Mobile-friendly interface for field use
• Bayed rack grouping for AV installs and multi-cabinet deployments
• Optional persistent storage with API-backed layout sync
• Self-hostable via Docker, Proxmox LXC, or bare metal
• Optional auth with local accounts or OIDC for shared deployments

You might ask, why should I make an imaginary rack like some sort of IT cosplay? And to that I would say, "fine then! don't! SCRAM!" but also, consider:

• Plan your layouts before you build them. It's a lot easier to move your mouse than that 4U server full of hard drives. Your shoulder will thank you.
• Document existing layouts so you know what is where.
• Because you can

Racks are measured in rack units, written U. One U is 1.75 inches of vertical space, and a common full-height rack is 42U. Rackula models racks in whole U: a device occupies a whole number of units and mounts at a whole-U boundary, the same way real rails register equipment under the EIA-310 standard. If something sits at U5, it is really at U5, not floating part of a unit above it.

Gear smaller than 1U, like half-height brackets or side-by-side half-width pairs, does not bolt to the rails on its own. It rides inside a 1U carrier (a bracket, tray, or shelf) that takes up one whole U and holds the smaller devices. The carrier registers to the rails, and the small devices register to the carrier.

count.racku.la no account, no install, just racks.

This is a quick run of the client-side only frontend (no persistence across browser sessions):

docker run -d -p 8080:8080 ghcr.io/rackulalives/rackula:latest

Or with Docker Compose:

curl -fsSL https://raw.githubusercontent.com/RackulaLives/Rackula/main/deploy/docker-compose.persist.yml -o docker-compose.yml
mkdir -p data && sudo chown 1001:1001 data
docker compose up -d

Open http://localhost:8080 and get after it.

git clone https://github.com/RackulaLives/Rackula.git
cd Rackula && npm install && npm run build

Serve the dist/ folder however you like. It's just files.

Note: LXC is currently in pre-release. See the Self-Hosting Guide for details and manual install instructions.

For production deployments, configure API security and authentication:

# Generate secrets
openssl rand -hex 32  # API write token
openssl rand -hex 32  # Session secret (if using auth)

Set CORS_ORIGIN, RACKULA_API_WRITE_TOKEN, and optionally RACKULA_AUTH_MODE (none, local, or oidc) in your .env file.

See the Self-Hosting Guide for full configuration details including auth modes, env vars, and TLS setup.

This project was built using AI-assisted development with Claude. I told it what to build and then said "no, not like that" a lot. The AI did a lot of typing. Commits with substantial AI contributions are marked with Co-authored-by tags because we're not going to pretend otherwise.

• Architecture Overview
• Technical Spec
• Self-Hosting Guide
• Changelog
• Contributing Guide
• Discussions

Built for the r/homelab and r/selfhosted communities. Colours from Dracula Theme. Device data from NetBox devicetype-library. See ACKNOWLEDGEMENTS.md for full credits.

MIT Copyright © 2025-2026 Gareth Evans