docs: consolidate community PRs and resolve grounded issues#455
Open
bakerboy448 wants to merge 14 commits into
Open
docs: consolidate community PRs and resolve grounded issues#455bakerboy448 wants to merge 14 commits into
bakerboy448 wants to merge 14 commits into
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
libicu-dev(self-contained .NET needs system ICU; the submitted hardcodedlibicu76only works on Debian 13 / Ubuntu 25.x) — Closes Fix dependencies on debian servarr-install-script.sh #454Issues resolved
X-Forwarded-Hoston lidarr/readarr/whisparr and tidies prowlarr. Grounded: all apps processForwardedHeaders.XForwardedHostinNzbDrone.Host/Startup.cs, soHostdoes not convey the external port — Closes Reverse proxy docs inaccurate when using non-standard ports #383sqlite3CLI install (distinct from bundledlibsqlite3), version fallback to the UI method, and aPRAGMA integrity_checkstep — Closes Instructions to fix "database disk image is malformed" could be expanded #438erosbuild artifacts (last build Jan 2026, since purged);erosnow 404s and no other branch serves a native V3 build — V3 is Docker-only. V2 native install is unaffected — Closes Community install script fails to install Whisparr V3 #439tmdb_id(suggested in the thread) does not exist in source, so not added — Closes Add documentation for JSON/RSS formats #209Closed — verified not actionable (grounded)
{MediaInfo BestAudioCodec}— token does not exist in Radarr;FileNameBuilder.csregisters onlyAudio/AudioCodec/AudioChannels/AudioLanguages/AudioLanguagesAllApplications/: LazyLibrarian, Lidarr, Mylar, Radarr, Readarr, Sonarr, Whisparr); Qui is not oneMovie.Path,DiskScanService) andradarr/faq.mdalready documents the limitationCloses #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:
ReconfigureLoggingsets
MaxArchiveFiles = LogRotate, default 50) — the "5/6" value reflectedonly the pre-config bootstrap.
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 largerpre-existing broken-link/anchor backlog remains and is out of scope here.
Deprecations
deprecatedtag — Refs [Suggestion] Docker-Compose in a Container for Synology ARM devices causes bugs -> use the official latest version! #402Left open (need follow-up, not closed here)
docker-compose, requiresversion:), so the syntax can't be safely modernized without replacing the bootstrap and validating on Synology ARM hardware. A deprecation banner has been added in the meantime.