> For the complete documentation index, see [llms.txt](https://wiki.crosswatch.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-others/auth-tautulli.md).

# Auth: Tautulli

Tautulli is a companion app for Plex. It tracks plays and keeps long-term history and stats.

{% tabs %}
{% tab title="End users" %}

### What it supports

* History (import/source only)

{% hint style="warning" %}
Tautulli is **read-only** in CrossWatch. It’s meant for importing existing Plex history, not for syncing back into Plex.
{% endhint %}

<figure><img src="/files/XSwa6MsAarSyXPEiVkSU" alt=""><figcaption></figcaption></figure>

### Connect Tautulli

1. Enter your **Server URL** and **API Key**.
   * Find the API key in Tautulli: **Settings → Web Interface → API**
2. Optional: set a **User ID**.
   * If you don’t set one, CrossWatch imports history for **all users**.
   * To find it:
     1. In Tautulli, open **Users**
     2. Click the user you want
     3. Check the browser URL: `/user?user_id=9999999`
3. Click **Connect** and wait until you see “Connected”.

### Troubleshooting

* Make sure the **Server URL** is reachable from the CrossWatch container.
* If imports are empty, verify the correct **User ID** (or remove it to import all users).
  {% endtab %}

{% tab title="Power users" %}

### Config keys

Stored under:

* `tautulli.server_url`
* `tautulli.api_key`
* `tautulli.user_id` (optional)

### Related docs

* Sync module: [Tautulli module](/blueprint-architecture/sync/_mod_tautulli.md)
* Adapter: [Adapter: Tautulli](/crosswatch/providers/synchronization/adapter-tautulli.md)
  {% endtab %}
  {% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/crosswatch/providers/authentication/auth-others/auth-tautulli.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.
