Skip to content

Commit 6b73974

Browse files
committed
site: note host-networking FlareSolverr URL in guides
The flaresolverr hostname only resolves on a shared Docker network, so host-networking deployments must use http://localhost:8191/v1. Add the caveat to the landing page, getting-started and migration guides, and the install.sh compose comment.
1 parent 2989187 commit 6b73974

4 files changed

Lines changed: 9 additions & 5 deletions

File tree

site/guides/getting-started.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -206,7 +206,7 @@ <h2 id="docker-compose-setup">Docker Compose setup</h2>
206206
</div>
207207

208208
<div class="note">
209-
<strong>OpenSubtitles.org:</strong> in v2.4 OpenSubtitles.org is a native <a href="provider-hub.html">Provider Hub</a> plugin you install from the Marketplace. It scrapes the site in-process, so there is no separate scraper container. The FlareSolverr service above is recommended: set its <code>/v1</code> URL (e.g. <code>http://flaresolverr:8191/v1</code>) in the plugin's <strong>FlareSolverr URL</strong> setting so it can solve Cloudflare challenges when needed.
209+
<strong>OpenSubtitles.org:</strong> in v2.4 OpenSubtitles.org is a native <a href="provider-hub.html">Provider Hub</a> plugin you install from the Marketplace. It scrapes the site in-process, so there is no separate scraper container. The FlareSolverr service above is recommended: set its <code>/v1</code> URL (e.g. <code>http://flaresolverr:8191/v1</code>) in the plugin's <strong>FlareSolverr URL</strong> setting so it can solve Cloudflare challenges when needed. If you run Bazarr+ with host networking (<code>network_mode: host</code>), use <code>http://localhost:8191/v1</code> instead, since the <code>flaresolverr</code> hostname only resolves on a shared Docker network.
210210
</div>
211211

212212
<h2 id="first-login">First login</h2>

site/guides/migration.html

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -167,15 +167,16 @@ <h2 id="container-swap-process">Container swap process</h2>
167167
</div>
168168
</li>
169169
<li>
170-
<strong>Add the companion services.</strong> The only companion service recommended now is FlareSolverr, plus the optional AI translator. OpenSubtitles.org is a native <a href="provider-hub.html">Provider Hub</a> plugin in v2.4: install it from the Marketplace, then point its <strong>FlareSolverr URL</strong> setting at the flaresolverr service below. There is no separate scraper container anymore.
170+
<strong>Add the companion services.</strong> The only companion service recommended now is FlareSolverr, plus the optional AI translator. OpenSubtitles.org is a native <a href="provider-hub.html">Provider Hub</a> plugin in v2.4: install it from the Marketplace, then point its <strong>FlareSolverr URL</strong> setting at the flaresolverr service below (<code>http://flaresolverr:8191/v1</code> on a shared Docker network, or <code>http://localhost:8191/v1</code> if Bazarr+ runs with host networking). There is no separate scraper container anymore.
171171
<div class="code-wrap" style="margin-top: 12px;">
172172
<div class="code-header">
173173
<span class="code-lang">docker-compose.yml additions</span>
174174
<button class="copy-btn" data-copy-from="migration-scraper-code" aria-label="Copy companion services config">Copy</button>
175175
</div>
176176
<pre id="migration-scraper-code"><code># Add these services:
177-
# Recommended for the OpenSubtitles.org plugin. Set this container's
178-
# /v1 URL (http://flaresolverr:8191/v1) in the plugin's FlareSolverr URL.
177+
# Recommended for the OpenSubtitles.org and many other plugins. Set this container's
178+
# /v1 URL (http://flaresolverr:8191/v1) in the plugin's FlareSolverr URL
179+
# (use http://localhost:8191/v1 instead if Bazarr runs with host networking).
179180
flaresolverr:
180181
image: ghcr.io/flaresolverr/flaresolverr:latest
181182
container_name: flaresolverr

site/index.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -402,7 +402,8 @@ <h2 id="quickstart-heading">Up and running in under a minute</h2>
402402

403403
# FlareSolverr (recommended): solves Cloudflare challenges for the native
404404
# OpenSubtitles.org plugin. After installing the plugin from the Marketplace,
405-
# set its FlareSolverr URL to http://flaresolverr:8191/v1 in the provider settings.
405+
# set its FlareSolverr URL to http://flaresolverr:8191/v1 in the provider settings
406+
# (or http://localhost:8191/v1 if you run Bazarr with host networking).
406407
flaresolverr:
407408
image: ghcr.io/flaresolverr/flaresolverr:latest
408409
container_name: flaresolverr

site/install.sh

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -318,6 +318,8 @@ generate_compose() {
318318
# FlareSolverr service. The native OpenSubtitles.org plugin reads its FlareSolverr URL
319319
# from the provider settings in the UI (http://flaresolverr:8191/v1), so no env var is
320320
# wired here; we only make Bazarr wait for FlareSolverr to be healthy when it is enabled.
321+
# Compose puts both services on the same network, so the flaresolverr hostname resolves.
322+
# If you switch Bazarr to host networking, use http://localhost:8191/v1 instead.
321323
if [[ "$flaresolverr" == "y" ]]; then
322324
flare_block="
323325
flaresolverr:

0 commit comments

Comments
 (0)