# Getting Started

- [About CrossWatch](https://wiki.crosswatch.app/getting-started/about-crosswatch.md): Self-hosted watchlist, history, ratings, and resume progress sync plus real-time scrobbling for Plex/Jellyfin/Emby and Trakt/SIMKL/MDBList/AniList/TMDb.
- [Limitations](https://wiki.crosswatch.app/getting-started/limitations.md): Soft size guidance, provider plan limits, and request-throttling limits that affect CrossWatch behavior.
- [Docker setup](https://wiki.crosswatch.app/getting-started/docker-setup.md): Run CrossWatch in Docker and persist state by mounting /config.
- [First-time setup](https://wiki.crosswatch.app/getting-started/first-time-setup.md): Connect providers, add TMDb metadata, create your first pair, then (optionally) enable Watcher for real-time scrobbling.
- [What do you need?](https://wiki.crosswatch.app/getting-started/first-time-setup/what-do-you-need.md): Choose between periodic syncing and real-time scrobbling, based on what you want to keep in sync.
- [Syncing](https://wiki.crosswatch.app/getting-started/first-time-setup/what-do-you-need/syncing.md): Align watchlists, history, and ratings between services. Start with one-way + one feature + dry run, then scale up.
- [Sync results](https://wiki.crosswatch.app/getting-started/first-time-setup/what-do-you-need/syncing/sync-results.md): What the Done counters mean after a sync run.
- [Webhook or Watcher](https://wiki.crosswatch.app/getting-started/first-time-setup/what-do-you-need/webhook-or-watcher.md): Pick a scrobble mode. Watcher is recommended. Legacy webhooks are deprecated.
- [Best practices](https://wiki.crosswatch.app/getting-started/best-practices.md): Recommended defaults for safe syncing, conflict handling, and operational hygiene.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.crosswatch.app/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
