Skip to content

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:

  1. In the app, open Settings → Help → Diagnostics.
  2. Click Send to server owner.
  3. 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 (together for Watch Together, scanner, http and 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:

SettingDefaultWhat it does
MOOVO_LOG_LEVELinfoThe least important level that's kept.
MOOVO_LOG_DIRdata/logsWhere the files go.
MOOVO_LOG_FILE_MB10The size of each file.
MOOVO_LOG_FILES5How many older files to keep.
MOOVO_LOG_FILEonoff 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.