diff --git a/docs/Configuration.md b/docs/Configuration.md index b98e1308..efe6bbb3 100644 --- a/docs/Configuration.md +++ b/docs/Configuration.md @@ -54,6 +54,25 @@ Proper DNS is preferred. Plex discovery and failover can depend on resolvable Pl `Test Connection` is disabled until you are authenticated and have either selected a discovered server or enabled manual override with saved settings. ::: +
+Server list is empty (VPS, cloud host, or custom networking) + +Maintainerr only lists Plex servers that publish a **reachable** connection to plex.tv. If authentication succeeds but the server dropdown stays empty, Plex is most likely publishing only a `local` connection that Maintainerr (running elsewhere) cannot use. This is common when Plex runs on a **VPS / cloud host** or behind unusual networking, where Plex's automatic Remote Access cannot detect a public connection. + +Fix it on the Plex side by publishing a reachable address: + +1. In Plex Web, open `Settings → (your server) → Network` and click **Show Advanced** (top-right) to reveal `Custom server access URLs`. +2. Into that comma-separated field, add a reachable **HTTPS** URL — e.g. your server's `*.plex.direct` address: `https://..plex.direct:32400`. The `.plex.direct` host keeps a valid certificate (a reverse-proxied domain with its own cert works too). Including the port is recommended; otherwise Plex falls back to your Remote Access port. You can usually copy the correct address from Seerr if it's connected to the same Plex server. +3. Save and restart Plex. On some Docker images this setting is an environment variable instead — e.g. `PLEX_ADVERTISE_URL` on the hotio image — in which case set it there (the in-app field is managed by that variable). + +Back in Maintainerr, press the **Refresh icon** next to the server selector — the server now appears in the list. + +:::tip +If Maintainerr and Plex share a Docker network, you can instead skip discovery and point Maintainerr at Plex's **internal** address (e.g. `http://plex:32400`) with manual connection override below. +::: + +
+
Advanced: manual connection override