# Troubleshooting

All rights reserved - Thomas / TuxiNet

## OLA kan ikke se USB

- Bekræft `lsusb`, `systemctl status olad` og at korrekt OLA-plugin er aktivt.
- Genstart OLA før du genpatcher porten i UI.

## Permission denied på `/dev/ttyUSB*`

- Sørg for at `tuxdmx` er medlem af `dialout` og `plugdev`.
- Bekræft udev-rettigheder eller device-ejerskab.

## Ingen DMX-output

- Bekræft universe, port og fixtureaddress.
- Kontroller, at blackout ikke er aktiv.
- Se DMX monitor for current/target/source.

## Flimren

- Reducér frame rate til 25 eller 30 fps.
- Kontroller at ingen overliggende effekt skriver LTP/HTP utilsigtet.

## Web UI virker ikke

- Kontroller `tuxdmx.service`.
- Brug `/api/v1/health` og se browser-konsol for WebSocket-fejl.
- Kør `systemctl status tuxdmx.service --no-pager --full`.
- Kør `journalctl -u tuxdmx.service -n 200 --no-pager`.

## Frontend-build eller pnpm fejler

- Kontroller `node --version` og bekræft Node 20.
- Kontroller `pnpm --version` og bekræft `10.28.2`.
- Kontroller at `package.json` har `packageManager: pnpm@10.28.2`.
- Hvis build skal genbruges fra en CI-artefakt, brug `--skip-frontend-build` kun naar `frontend/dist/index.html` allerede findes.

## No module named `app`

- Kontroller at backend er landet som `/opt/tuxdmx/backend/app`.
- Kontroller `test -f /opt/tuxdmx/backend/app/main.py`.
- Kør importtesten som servicebrugeren:
  `sudo -u tuxdmx /opt/tuxdmx/.venv/bin/python -c "import sys; sys.path.insert(0, '/opt/tuxdmx/backend'); import app.main"`

## PermissionError på `frontend/dist` eller `data/backups`

- Installeren normaliserer rettigheder til `root:tuxdmx` for appkode og `tuxdmx:tuxdmx` for runtime-data.
- Kontroller `sudo -u tuxdmx test -r /opt/tuxdmx/frontend/dist/index.html`.
- Kontroller `namei -l /opt/tuxdmx/frontend/dist/index.html`.

## MixItUp timeout

- Bekræft at endpointet returnerer `202 Accepted`.
- Kontroller rate limiting, token og netværksrute.

## BPM finder forkert tempo

- Justér BPM-range og half/double.
- Brug syntetiske click tracks for at isolere lydinputproblemer.

## Databasefejl

- Kontroller diskplads og SQLite WAL-filer.
- Kør backup før restore eller manuel reparation.
- Kontroller at `tuxdmx` kan skrive til `/var/lib/tuxdmx`.
- Kontroller `sqlite3 /var/lib/tuxdmx/tuxdmx.db "PRAGMA integrity_check;"`.

## OLA kan ikke importeres i virtualenv

- Virtualenv skal oprettes med `python3 -m venv --system-site-packages /opt/tuxdmx/.venv`.
- Kontroller:
  `sudo -u tuxdmx /opt/tuxdmx/.venv/bin/python -c "import ola; print(ola.__file__)"`