Overview
WolfStack’s 3D Server Room is an interactive virtual data centre that visualises your entire infrastructure as physical server racks you can walk through, inspect, and manage — both on a regular screen and in virtual reality with a VR headset.
Every node in your cluster is rendered as a server rack. Each rack contains individual server units representing the host machine and every Docker container, LXC container, and VM running on it. Status LEDs, container names, and cluster groupings update in real time.
Desktop Mode
The 3D Server Room works in any modern browser without a VR headset. Click the 🖥️ icon in the sidebar to open it.
Navigation
| Control | Action |
|---|---|
| Mouse drag | Orbit the camera around the server room |
| Scroll wheel | Zoom in and out |
| WASD / Arrow keys | Walk forward, back, left, right |
| Click a rack | Show server info panel with CPU, memory, disk, and container list |
| Double-click a rack | Navigate to the node’s dashboard |
Info Panel
Click any server rack to see:
- Hostname and IP address
- Online/offline status
- CPU, memory, and disk usage percentages
- Full list of Docker containers, LXC containers, and VMs with running state
- Terminal button — open a console to the node or any container
- Dashboard button — jump to the node’s management page
VR Mode
If you have a VR headset (Meta Quest, Valve Index, HTC Vive, or any WebXR-compatible device), click the Enter VR button to step into your server room.
Requirements
- A WebXR-compatible VR headset
- A browser that supports WebXR (Meta Quest Browser, Chrome, Firefox)
- HTTPS connection (WebXR requires a secure context)
VR Controls
| Control | Action |
|---|---|
| Thumbsticks | Walk around the server room |
| Laser pointer | Red laser beam from each controller for aiming |
| Trigger (on server unit) | Show info panel for that container/VM |
| Trigger (on info panel button) | Open terminal or navigate to dashboard |
| Trigger (on keyboard) | Press virtual keyboard keys in the terminal |
| Trigger (on empty space) | Dismiss the info panel |
In-Scene Terminal
When you open a terminal in VR, a floating screen appears in front of you showing a live terminal session. A virtual QWERTY keyboard floats below the screen — point at keys with the laser and pull the trigger to type. The terminal connects directly to the selected host, Docker container, or LXC container.
- Full QWERTY layout with shift, caps lock, backspace, tab, enter, escape
- Keys flash red when pressed
- Red close button (X) in the top-right corner
- Only one terminal open at a time — opening a new one closes the previous
VNC Console (VMs)
QEMU virtual machines open a graphical VNC console instead of a text terminal. The VNC output is rendered directly in the VR scene via a hidden iframe capturing the noVNC client’s canvas.
Server Rack Layout
Racks are arranged in rows grouped by cluster. Each rack represents one node in your infrastructure:
| Position | What It Represents | Visual Indicators |
|---|---|---|
| Top server (HOST) | The physical/virtual host machine | Slightly taller, brighter panel, cluster-colour accent stripe |
| Below: Docker containers | One server unit per Docker container | Blue type indicator, container name label |
| Below: LXC containers | One server unit per LXC container | Green type indicator, container name label |
| Bottom: VMs | One server unit per virtual machine | Amber type indicator, VM name label |
Status LEDs
Each server unit displays three LED indicators on its front panel showing real-time resource usage:
| LED | Metric | Green | Amber | Red |
|---|---|---|---|---|
| 1st (left) | CPU | < 50% | 50 – 80% | > 80% |
| 2nd (middle) | Memory | < 70% | 70 – 90% | > 90% |
| 3rd (right) | Storage | < 70% | 70 – 90% | > 90% |
LEDs only appear when real metrics data is available. Offline servers show a single dim red LED. A pulsing red ! warning appears above any rack with critical metrics.
Container LEDs show per-container CPU and memory usage from Docker/LXC stats. Host LEDs show node-level metrics. Stats refresh every 60 seconds.
Cluster Visualisation
- Racks are grouped by cluster with colour-coded accent strips (red, blue, green, amber, etc.)
- Cluster name labels float above each group of racks
- Server hostnames are displayed vertically on the side of each rack
- Supports mixed WolfStack and Proxmox clusters in the same view
Features
- Real-time updates — Node status, container counts, and metrics refresh automatically
- Container names — Lazy-loaded from all nodes on scene load, showing real Docker/LXC/VM names
- Proxmox support — PVE guests fetched via the Proxmox API with per-guest CPU/memory/disk stats
- VR Ready indicator — HUD shows whether a VR headset is detected
- Responsive — Resizes when the sidebar is toggled
- Dark atmosphere — Moody server room lighting with fog, shadows, and reflective floor
- Toggle labels — Show or hide hostname and cluster labels
- Auto-rotate — Optional camera rotation (off by default)