Skip to content

Troubleshooting & FAQ

People can't connect from outside

  • Double-check MOOVO_PUBLIC_URL matches the address they use, including the port.
  • If you port forward, test from your phone on mobile data (not your Wi-Fi). If it fails, you may be behind CGNAT: use a tunnel or Tailscale.
  • Make sure the machine isn't asleep and Docker is running.

Posters are missing

Add a TMDB key in Admin → Settings (it's free), then Admin → Library → Refresh metadata. Check that folders follow the naming layout.

A title was matched to the wrong movie

Open it in the app → More → Fix match, search for the right one, and it sticks through future scans.

Downloads are slow

Downloads go from your server's upload to their download. Check the upload cap in Admin → Settings, and remember everyone downloading at once shares your upload. The apps pace themselves and resume after interruptions, so a slow download still finishes.

Watch Together says someone is "downloading"

Everyone plays their own copy. The session starts automatically once everyone's copy is ready, and the lobby shows each person's progress.

"Windows protected your PC"

If you see this for a build that isn't code-signed yet, click More info → Run anyway once. Signed builds don't show it.

The setup code doesn't work

It's single-use and only valid while the server has no owner. Restart the container to print a fresh one, or use MOOVO_ADMIN_USERNAME/MOOVO_ADMIN_PASSWORD for a scripted setup.

Still stuck?

Email us at the address in the footer with what you tried and the relevant lines from docker compose logs. Remove anything private (addresses, keys) first.