Publish LumaOps source

2026-09-03 01:18:36 +02:00
commit 7f1c0e5f71
2363 changed files with 501543 additions and 0 deletions
@@ -0,0 +1,59 @@
+# LumaOps op Unraid
+
+## Voorbereiding
+
+LumaOps bouwt één image met OpenRGB Core, de FastAPI-backend en de statische React-app. De veilige standaard is bridge networking, een read-only rootfilesystem en alleen expliciete hardwaredevices. Alle Linux-capabilities worden verwijderd, behalve CHOWN, SETUID en SETGID die de root-entrypoint kort nodig heeft om volumes en PUID/PGID in te stellen; na de overstap draait de applicatie als Unraid nobody/users via PUID=99 en PGID=100.
+
+Maak appdata aan:
+
+    mkdir -p /mnt/user/appdata/lumaops/{openrgb,config,data,logs}
+
+Kloon de repository, kopieer .env.example naar .env en bouw:
+
+    git clone REPOSITORY-URL
+    cd LumaOps
+    cp .env.example .env
+    # Genereer een unieke token met: openssl rand -base64 32
+    # en vervang LUMAOPS_ADMIN_TOKEN in .env.
+    docker compose build
+    docker compose up -d
+    docker compose ps
+
+Pas in docker-compose.yml de hostpaden aan naar /mnt/user/appdata/lumaops wanneer Compose vanuit een andere map draait. Voor de Unraid GUI kan docker/unraid-lumaops.xml als templatebasis worden gebruikt. Bij een lokale build blijft Repository lumaops:0.1.0.
+
+## Netwerkmodi
+
+Bridge is standaard en publiceert alleen de webinterface: extern `WEB_PORT=1223` naar intern `APP_PORT=8080`. Open dus `http://UNRAID-IP:1223`. Poort 6742 ontbreekt doelbewust bij `ports`.
+
+Voor OpenRGB-netwerkcontrollers die UDP broadcast, multicast of mDNS nodig hebben:
+
+    docker compose -f docker-compose.yml -f docker/compose.host-network.yml up -d
+
+De override verwijdert de webpoortmapping omdat host networking die niet gebruikt. LumaOps luistert dan rechtstreeks op `WEB_PORT` (standaard 1223). `OPENRGB_HOST` blijft 127.0.0.1, ook in host mode.
+
+## Bijwerken
+
+    git fetch origin
+    git pull --ff-only origin main
+    docker compose build --pull
+    docker compose up -d --remove-orphans
+    docker image prune
+
+Maak vooraf een appdata-back-up. Databaseback-ups in de UI vervangen geen kopie van de volledige appdata. Een rollback gebruikt een vorige Git-commit/tag en daarna dezelfde build/up-opdrachten.
+
+## Productiecontrole
+
+    docker compose ps
+    docker inspect --format "{{json .State.Health}}" lumaops
+    docker exec lumaops /opt/venv/bin/python /opt/lumaops/healthcheck.py
+    docker exec lumaops sh -c "ss -ltn 2>/dev/null || true"
+
+Verwacht: web bereikbaar op hostpoort 1223, SDK alleen op 127.0.0.1:6742 en health healthy. Een ontbrekend hardwaredevice mag de webapp niet neerhalen; readiness wordt degraded/unhealthy met hersteladvies.
+
+## Authenticatie
+
+Login staat standaard aan en vereist een unieke `LUMAOPS_ADMIN_TOKEN` van minstens
+32 tekens. Voor rechtstreekse HTTP-toegang op een vertrouwd LAN blijft
+`SECURE_COOKIES=false`; zet dit op `true` achter HTTPS. Zet bij internettoegang ook
+`EXTERNAL_ACCESS=true` en voeg alleen bekende proxyadressen toe aan
+`TRUSTED_PROXIES`. Publiceer LumaOps nooit rechtstreeks zonder TLS.