Skip to content
Pascal van den Berg edited this page Sep 21, 2025 · 37 revisions

CrossWatch – FAQ & Troubleshooting

TL;DR

  • Back up /config before doing anything risky.
  • Back up Jellyfin / Plex / Trakt / SIMKL cause things can go quickly when using the wrong settings
  • Use the built-in Troubleshoot actions after every change in pairs or/and feature changes.
  • Two-way sync can propagate mistakes instantly. Think twice, click once.

Basics

What is CrossWatch?
A self-hosted sync engine that keeps your Plex / Jellyfin / Trakt / Simkl (and friends) watchlists & ratings aligned. Clean web UI, JSON state on disk, and a simple container.

What’s stable right now?

  • Watchlist sync (1-way or 2-way)
  • Live scrobbling (Plex → Trakt)
  • Ratings sync
  • Watch history
  • playlists: present but intentionally disabled until hardened

Where does CrossWatch store my stuff?
Inside the container at /config (mounted from your host), e.g.:

Clone this wiki locally