Repository navigation
Configuration
RackDaddy Lab is configured with environment variables, set in a .env file next to docker-compose.lab.yml (or in the compose environment: block). After changing them, apply with docker compose -f docker-compose.lab.yml up -d.
| Variable | Default | Purpose |
|---|---|---|
LAB_PORT |
8080 |
Host port the web UI binds to. |
SITE_NAME |
Lab |
Friendly name shown in the top bar (you can also set this per site in the UI). |
APP_NAME |
RackDaddy |
Product name shown in the UI. |
| Variable | Default | Purpose |
|---|---|---|
DB_PASSWORD |
change_me_in_production |
PostgreSQL password. Set this before the first start. |
LOCAL_AUTH_USER |
admin |
Sign-in username. |
LOCAL_AUTH_PASSWORD_HASH |
hash of rackdaddy
|
scrypt salt:hash of the password. See Installation for how to generate one. |
LOCAL_AUTH_SECRET |
change-this-to-a-long-random-secret |
Session token signing secret. Set a long random value. |
All optional. Unset means no live telemetry (the app still runs). See Live Monitoring.
| Variable | Default | Purpose |
|---|---|---|
INFLUX_URL |
http://localhost:8086 |
InfluxDB base URL. |
INFLUX_TOKEN |
(unset) | InfluxDB read token. |
INFLUX_ORG |
(unset) | InfluxDB organization. |
INFLUX_BUCKET |
cabinet-sensors |
Bucket for per-cabinet sensor readings. |
ZONE_BUCKET |
zone-sensors |
Bucket for cold-aisle zone readings. |
ZONE_TOKEN |
falls back to INFLUX_TOKEN
|
Separate token for the zone bucket, if you use one. |
POWER_TOKEN |
falls back to INFLUX_TOKEN
|
Separate token for the power bucket, if you use one. |
Buckets, zones, and meters can also be set per site in Site Configurator > Data Sources, which overrides these defaults.
| Variable | Default | Purpose |
|---|---|---|
DEVICE_IMAGES_PACK_URL |
public RackDaddy device-image release | Where the Download real images button pulls the pack from. Point it at your own mirror if needed. See Device Library and Images. |
The Lab uses named Docker volumes: pgdata (the database), uploads (device images, generated placeholders, users, and other runtime state), and devicetype-library (the optional cloned device-type library). Back these up with docker run --rm -v <volume>:/data -v $PWD:/backup alpine tar czf /backup/<volume>.tgz -C /data . or by dumping the database with pg_dump.