34 lines
2.0 KiB
Markdown
34 lines
2.0 KiB
Markdown
# 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.
|