Skip to content

docs: consolidate community PRs and resolve grounded issues#455

Open
bakerboy448 wants to merge 14 commits into
Servarr:masterfrom
bakerboy448:docs/community-pr-consolidation
Open

docs: consolidate community PRs and resolve grounded issues#455
bakerboy448 wants to merge 14 commits into
Servarr:masterfrom
bakerboy448:docs/community-pr-consolidation

Conversation

@bakerboy448

@bakerboy448 bakerboy448 commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Summary

Consolidates the actionable open community PRs and resolves grounded issues. Every change was verified against the actual *arr source or authoritative docs — not the contributor's word — after several reported "facts" turned out to be wrong.

Cherry-picked from open PRs

Issues resolved

Closed — verified not actionable (grounded)

Closes #434
Closes #445
Closes #444
Closes #450
Closes #448
Closes #432
Closes #437
Closes #441

Audit corrections (source-grounded re-review of the earlier audit commit)

Every change was re-challenged against the actual *arr source; two prior
"audit" edits were wrong and are corrected here:

  • Rolling log-file count restored to 51 total (source: ReconfigureLogging
    sets MaxArchiveFiles = LogRotate, default 50) — the "5/6" value reflected
    only the pre-config bootstrap.
  • Lidarr SQLite guidance restored: Lidarr does bundle libe_sqlite3.so
    (verified in running containers; SourceGear.sqlite3), so the old-OS/GLIBC
    root cause and symlink workaround are the correct fix — not "just install
    libsqlite3-0".

Broken-link fixes

Repaired genuinely-broken internal links surfaced by a wiki-wide scan
(Radarr/Readarr #windows → the Windows install page; Radarr/Readarr/Whisparr
#twitter#twitter-connect; Prowlarr FAQ backup anchor). A larger
pre-existing broken-link/anchor backlog remains and is out of scope here.

Deprecations

Left open (need follow-up, not closed here)

bakerboy448 and others added 14 commits June 30, 2026 17:27
Follow-on to Servarr#452. Source-grounded corrections verified against local app
clones on the documented release branches (Sonarr main = v4; Radarr,
Lidarr, Prowlarr develop). Includes factual fixes (stylelint script name,
FreeBSD data-dir contradiction, Mono->Package headings, CONTRIBUTING
markdownlint config + workflow name), broken link/anchor fixes, and
filled stubs (Sonarr tips-and-tricks, install sections).

Whisparr is intentionally excluded (its v2 series-domain re-frame is a
separate effort). v5/dev-only claims (e.g. .NET10) were verified and NOT
applied -- the wiki documents the released line.
Managarr is a Rust TUI/CLI for managing *arr servers (Radarr/Sonarr/Lidarr).
Prunerr is a Plex/Sonarr/Radarr library-cleanup tool with a review queue.

Both repos verified to exist and match their descriptions.

Closes Servarr#443
Closes Servarr#449

Co-authored-by: Alex Clarke <39523942+Dark-Alex-17@users.noreply.github.com>
Co-authored-by: helliott20 <112109388+helliott20@users.noreply.github.com>
The leading-pipe line continuation is invalid in Windows PowerShell 5.1
(only parses in PowerShell 7+). Use a trailing pipe so the snippet works
in the shipped Windows PowerShell as the surrounding text states.

Closes Servarr#435

Co-authored-by: Stijnvi <145622904+Stijnvi@users.noreply.github.com>
The non-standard-port warning told Lidarr/Readarr/Whisparr users to set the
`Host` header; the apps read the forwarded host from `X-Forwarded-Host`
(NzbDrone.Host/Startup.cs configures ForwardedHeaders.XForwardedHost), so
`Host` does not convey the external port. Match the wording already used in
the Sonarr/Radarr guides and tidy the redundant Prowlarr block.

Closes Servarr#383
Add sqlite3 CLI install guidance (distinct from the bundled libsqlite3),
a version check with fallback to the UI method, and an integrity_check
verification step. Fix the "covered"/"recovered" typo.

Closes Servarr#438
Under podman the CNI/netavark bridge defaults to MTU 1500, which times out
Cloudflare-protected indexers while DNS and other sites work. Document
recreating the network with a lower MTU.

Closes Servarr#428
Upstream stopped publishing native eros build artifacts (last build was
3.1.0.2116 in Jan 2026, since purged from Azure DevOps); the eros update
endpoint now 404s and no other branch serves a native Whisparr V3 build.
Whisparr V3 is Docker-only upstream, so the menu option could only ever
fail. Remove it; native installs still cover Whisparr V2 via the whisparr
option. Bump script version to 3.1.18.

Closes Servarr#439
Self-contained .NET apps require system ICU, which isn't present on minimal
installs, causing the apps to fail to start. Add `libicu-dev` to the
prerequisites: it is version-agnostic and pulls the correct `libicuNN`
runtime for each Debian/Ubuntu release (libicu72 on Debian 12, libicu76 on
Debian 13, libicu70 on Ubuntu 22.04, libicu74 on 24.04, etc.), avoiding a
hardcoded version that only works on one release.

Closes Servarr#454
The guide dates from 2021 and depends on an unmaintained third-party
bootstrap pinning Docker 20.10.0 and Compose v1; it hasn't been validated
against current DSM and may no longer work. Add a deprecation banner and
tag so readers are warned before following it. A validated modern rewrite
is still needed.

Refs Servarr#402
Wrap the ANSI color variables in the `echo -e` lines so shellcheck no
longer flags SC2086. Quoting-only; no behavior change (the color codes
contain no whitespace or globs).
The audit commit changed the info-log count to "5 archived files" (Lidarr)
and "6 log files total" (Sonarr), reflecting only the pre-config bootstrap
value. Once config loads, ReconfigureLogging sets MaxArchiveFiles = LogRotate
(default 50), so the effective default is 51 total, matching the debug/trace
statements. Restore "51 log files total".
The audit rewrite claimed Lidarr does not bundle SQLite and loads the
system libsqlite3.so.0, reducing the fix to "apt install libsqlite3-0".
That is wrong and dropped the root-cause nuance (old OS / old GLIBC on
EOL distros). Verified against running containers: /app/bin/libe_sqlite3.so
is bundled and no system libsqlite3.so is present. Restore the original
section documenting the bundled build, the GLIBC requirement on EOL
distros (Debian 10/11, Ubuntu 18.04/20.04, older Synology DSM), and the
symlink-the-system-library workaround (recreated after each update).
- Radarr/Readarr multiple-instances "already installed" links pointed at a
  non-existent #windows anchor; point them at the Windows install page
  (matching the Sonarr fix).
- Radarr/Readarr/Whisparr supported.md Twitter link used #twitter; the
  section anchor is #twitter-connect.
- Prowlarr FAQ backup link used #how-do-i-backuprestore-my-prowlarr; the
  heading anchor is #how-do-i-backuprestore-prowlarr.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment