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,33 @@
+# Probleemoplossing
+
+## Webapp niet bereikbaar
+
+Controleer `docker compose ps`, de externe poort 1223/`WEB_PORT`, de interne `APP_PORT` (standaard 8080) en `/logs/backend.log`. De rootfilesystem is read-only; `/config`, `/data`, `/logs`, `/tmp` en `/run` moeten schrijfbaar zijn. Controleer PUID/PGID en appdata-eigenaarschap.
+
+## OpenRGB of SDK offline
+
+Bekijk /logs/openrgb.log en /logs/supervisor.log. De supervisor herstart OpenRGB met begrensde backoff; de webapp blijft beschikbaar en health wordt degraded. Controleer dat alleen 127.0.0.1:6742 gebruikt wordt:
+
+    docker exec lumaops python -c "import socket; print(socket.create_connection(('127.0.0.1',6742),2))"
+
+Publiceer 6742 niet om het probleem te omzeilen. Controleer versie 1.0rc3 en SDK-protocol 5.
+
+## Geen USB- of I²C-apparaten
+
+Doorloop de setupwizard opnieuw. Vergelijk host- en containerinventaris. Voeg /dev/bus/usb of alleen de benodigde /dev/i2c-* toe. Laad i2c-dev plus chipsetdriver op de host. Gebruik het privileged diagnoseprofiel alleen kort om een permissieverschil te bevestigen.
+
+## Network lights niet gevonden
+
+Bridge networking laat niet elk broadcast/multicast/mDNS-protocol door. Test de host-network override. Houd OPENRGB_HOST op 127.0.0.1. Controleer VLAN/firewall en of discovery is ingeschakeld.
+
+## Login werkt niet via HTTP
+
+Secure cookies vereisen HTTPS. Gebruik een reverse proxy met TLS. Alleen voor tijdelijke LAN-diagnose kan SECURE_COOKIES=false. EXTERNAL_ACCESS=true zonder AUTH_ENABLED wordt bij startup geweigerd.
+
+## Database of secrets
+
+SQLite-integriteitsfouten: stop de container en herstel een gecontroleerde back-up. Een ontbrekende secret.key kan niet cryptografisch worden gereconstrueerd; herstel dezelfde sleutel of configureer connectorsecrets opnieuw.
+
+## Diagnosepakket
+
+Download /api/v1/diagnostics/export via de UI. Het pakket bevat versies, schema zonder geheimen, hardwaretoegang, SDK-status, inventory, health en recente fouten. Request-id uit een foutmelding koppelt frontend, API en logs.