Diagnostics & logs
When something seems off (a movie night that kept drifting out of sync, a download that stalls), logs show what actually happened. The app and the server each keep their own, and neither ever holds passwords, keys or tokens.
Send your logs to the server owner
Anyone can do this, and it takes a minute:
- In the app, open Settings → Help → Diagnostics.
- Click Send to server owner.
- Say what happened, if you like ("the picture froze around 9:40"), then Send.
The bundle holds the last week of the app's logs, the app version, your operating system and time zone, and how well Watch Together kept in sync. No passwords, names or titles. It goes only to your server, never to us.
Diagnostics also lists the recent lines on screen, with filters, Copy these lines and Save logs… (a zip) if you'd rather send it another way.
Admin → Logs
The owner and admins read the server's logs in the app, under Admin → Logs:
- Filters: level (debug, info, warn, error), a search box, a chip for each part of the server (
togetherfor Watch Together,scanner,httpand so on), a time range, and under More filters a person, a device, a Watch Together session and a path. Click a line to see its details. - Live follows new lines as they arrive.
- Server keeps set to debug keeps more detail until the server restarts. Handy while you chase a problem.
- Download logs saves the filtered range as a zip.
- Reports lists the diagnostics people sent, to open or save. The server keeps the newest 100.
Where the server keeps them
Besides docker compose logs, the server writes its logs to data/logs: moovo.log, up to 10 MB, plus the five files before it. You can change that in the compose file:
| Setting | Default | What it does |
|---|---|---|
MOOVO_LOG_LEVEL | info | The least important level that's kept. |
MOOVO_LOG_DIR | data/logs | Where the files go. |
MOOVO_LOG_FILE_MB | 10 | The size of each file. |
MOOVO_LOG_FILES | 5 | How many older files to keep. |
MOOVO_LOG_FILE | on | off keeps logs in memory and docker compose logs only. |
Secrets are masked everywhere, including docker compose logs. If you forward logs to us, still look them over for addresses you'd rather keep private.