# Documentation Table of Contents **Purpose:** Quick navigation for AI to locate relevant documentation without reading all files. ## Authentication & Users - **Plex OAuth, JWT sessions, RBAC** → [backend/services/auth.md](backend/services/auth.md) - **Local admin authentication, password change** → [backend/services/auth.md](backend/services/auth.md) - **Admin-generated login token per user (URL-login)** → [backend/services/auth.md](backend/services/auth.md) - **Deleting users (any provider), returning user gets a new account** → [backend/services/auth.md](backend/services/auth.md#deleting-users), [admin-dashboard.md](admin-dashboard.md) - **Local accounts: self-registration and admin Add User (#77), shared creator, local login enabled** → [backend/services/auth.md](backend/services/auth.md#local-accounts-registration-and-admin-added), [admin-dashboard.md](admin-dashboard.md) - **Request file download link (token check, single file or zip, streaming backpressure #500)** → [backend/services/auth.md](backend/services/auth.md#request-file-download-link) - **How is a Discord account mapped to a user? (Discord identity link, actor resolver, admin link route; groundwork: no bot yet)** → [backend/services/auth.md](backend/services/auth.md#discord-identity-link), [admin-dashboard.md](admin-dashboard.md) - **API tokens, allowlist, GET /api/requests/:id (field list, BigInt sizes #261)** → [backend/services/api-tokens.md](backend/services/api-tokens.md) - **Route protection, auth guards** → [frontend/routing-auth.md](frontend/routing-auth.md) - **Login page UI/UX** → [frontend/pages/login.md](frontend/pages/login.md) - **Credential recovery (lost CONFIG_ENCRYPTION_KEY, locked-out admin)** → [admin-features/credential-recovery.md](admin-features/credential-recovery.md) - **Sign-in and sign-up attempt limits, known-browser cookie, client address key, rate-limit namespaces** → [backend/services/auth.md](backend/services/auth.md#local-admin-authentication), [deployment/unified.md](deployment/unified.md#security-notes) ## Configuration & Setup - **First-time setup wizard** → [setup-wizard.md](setup-wizard.md) - **Settings management, encryption** → [backend/services/config.md](backend/services/config.md) - **Settings UI (modular architecture, all tabs)** → [settings-pages.md](settings-pages.md) - **Settings architecture refactoring (Jan 2026)** → [settings-pages.md](settings-pages.md#architecture-refactored-jan-2026) - **Audiobook organization templates** → [settings-pages.md](settings-pages.md#audiobook-organization-template), [phase3/file-organization.md](phase3/file-organization.md#target-structure) - **Setup middleware & status check** → [backend/middleware.md](backend/middleware.md) - **API request validation (request size limits / readJsonBody, zod array bounds, validation error details/logging)** → [backend/validation.md](backend/validation.md) - **Environment variables, PUBLIC_URL, OAuth configuration** → [backend/services/environment.md](backend/services/environment.md) ## Database & Data Models - **PostgreSQL schema, tables, relationships** → [backend/database.md](backend/database.md) - **Prisma ORM, migrations** → [backend/database.md](backend/database.md) ## Plex Integration - **OAuth, library scanning, fuzzy matching** → [integrations/plex.md](integrations/plex.md) - **Availability status, plexGuid linking** → [integrations/plex.md](integrations/plex.md) ## Audiobookshelf Integration - **ABS API client, library scanning** → `src/lib/services/audiobookshelf/api.ts` - **ABS library service** → `src/lib/services/library/AudiobookshelfLibraryService.ts` - **ABS connection test, fetch failure reasons (#221)** → [setup-wizard.md](setup-wizard.md) (API Endpoints, Fixed Issues 8) - **Backend mode selection (Plex vs ABS)** → [backend/services/config.md](backend/services/config.md) - **File hash matching for accurate ASIN** → [fixes/file-hash-matching.md](fixes/file-hash-matching.md) - **ASIN read-back after the ABS match (#287)** → [fixes/file-hash-matching.md](fixes/file-hash-matching.md#asin-read-back-287) - **Requester tags `req:` on ABS items (#232), backfill job, eligibility, shared-name warnings** → [features/requester-tags.md](features/requester-tags.md) - **Explicit mark on requests → ABS item Explicit flag (#542), admin setting (off by default), API-key access guard, mark/clear rules, `requests.explicit`** → [features/explicit-flag.md](features/explicit-flag.md) - **Delivered request stuck in `downloaded` when ABS holds another ASIN (#284), library link by path / files hash** → [fixes/file-hash-matching.md](fixes/file-hash-matching.md#delivered-requests-link-to-the-library-item-284) - **Request card and details window show the edition ABS matched (#325a, #325), `audiobooks.library_asin`, follow on rematch** → [fixes/file-hash-matching.md](fixes/file-hash-matching.md#delivered-requests-follow-the-library-asin-325a) - **OIDC authentication** → [backend/services/auth.md](backend/services/auth.md) ## Reading Shelves (Goodreads, Hardcover) - **Goodreads shelf sync (RSS feeds)** → [backend/services/goodreads-sync.md](backend/services/goodreads-sync.md) - **Goodreads feeds ended (404, add message, shelf notice, one warning per sync; #514)** → [backend/services/goodreads-sync.md](backend/services/goodreads-sync.md#feeds-ended-514) - **Hardcover shelf sync (GraphQL API)** → [backend/services/hardcover-sync.md](backend/services/hardcover-sync.md) - **Shared sync core (Audible lookup, request creation)** → [backend/services/goodreads-sync.md](backend/services/goodreads-sync.md#shared-sync-core) - **Where a requested book's title, author and cover come from (Audible lookup; existing book keeps its saved title/author; a sent cover only if an Audible image)** → [backend/services/goodreads-sync.md](backend/services/goodreads-sync.md#shared-sync-core) - **Combined shelves API, GenericShelf** → [backend/services/goodreads-sync.md](backend/services/goodreads-sync.md) - **Hook factory (createShelfHooks)** → [backend/services/goodreads-sync.md](backend/services/goodreads-sync.md#hook-factory) - **Adding a new shelf provider** → [backend/services/goodreads-sync.md](backend/services/goodreads-sync.md#adding-a-new-provider) - **Watched authors & series (auto-request, Entire catalog vs New releases only, release cutoff, undated books, targeted check)** → [features/watched-lists.md](features/watched-lists.md) ## Audible Integration - **Web scraping (popular, new releases)** → [integrations/audible.md](integrations/audible.md) - **Database caching, real-time matching** → [integrations/audible.md](integrations/audible.md) - **Book covers API for login page** → [frontend/pages/login.md](frontend/pages/login.md) - **Dedup & works table (cross-ASIN identity)** → [integrations/audible.md](integrations/audible.md#dedup--works-table) - **Multi-narrator capture in HTML scrapers** → [integrations/audible.md](integrations/audible.md#narrator-capture-in-html-scrapers) - **Series page dual layout (modern/legacy A/B)** → [integrations/audible.md](integrations/audible.md#series-page-dual-layout) - **Series search (catalog API, ranking, book counts, error state)** → [integrations/audible-series-search.md](integrations/audible-series-search.md) - **Audible regions, language configs, adding a region, changing region** → [integrations/audible.md](integrations/audible.md#region-configuration) - **Audible language filter (admin setting, hidden counts, BookDate/shelf sync single pick)** → [integrations/audible-language-filter.md](integrations/audible-language-filter.md) ## E-book Support (First-Class) - **First-class ebook requests, separate tracking** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md) - **Multi-source ebook downloads (Anna's Archive + Indexer Search)** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md) - **Ebook indexer search (Prowlarr with ebook categories)** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md#flow-indexer-search) - **Ebook already in the book folder skips auto-grab (#313)** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md#on-disk-check-313) - **ASIN-based matching, format selection** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md) - **Ebook ranking algorithm (unified with audiobooks)** → [phase3/ranking-algorithm.md](phase3/ranking-algorithm.md#ebook-torrent-ranking) - **Direct HTTP downloads from Anna's Archive** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md) - **Ebook delete behavior (files only, torrents seed)** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md#delete-behavior) - **Kindle EPUB fix, read-back check of the fixed copy** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md#kindle-epub-fix) - **Ebook settings (3-section UI)** → [settings-pages.md](settings-pages.md#e-book-sidecar) - **Indexer categories (audiobook/ebook tabs)** → [settings-pages.md](settings-pages.md#indexer-categories-tabbed) - **Per-indexer settings mapping (ratio limit, seeding time, priority)** → [settings-pages.md](settings-pages.md#api-endpoints) ## Automation Pipeline - **Full pipeline overview** → [phase3/README.md](phase3/README.md) - **Search via Prowlarr (torrents + NZBs)** → [phase3/prowlarr.md](phase3/prowlarr.md) - **Torrent ranking/selection** → [phase3/ranking-algorithm.md](phase3/ranking-algorithm.md) - **Automatic-search match gates (one-word titles, required numbers, author whole words, volume conflict, #223)** → [phase3/match-gates.md](phase3/match-gates.md) - **Multi-download-client support (qBittorrent, Transmission, Deluge, SABnzbd, NZBGet; base32 magnets, torrent IDs)** → [phase3/download-clients.md](phase3/download-clients.md) - **.torrent/.nzb fetch, redirects, Prowlarr key scoping, which server answered a failed grab (401/403 hint), user-picked release validation** → [phase3/download-clients.md](phase3/download-clients.md#source-fetch--prowlarr-key-scoping) - **Custom download category / label, a category another app already uses (ownership, SABnzbd category list #579)** → [phase3/download-clients.md](phase3/download-clients.md#download-categories-46-579) - **Admin Add Torrent (a magnet link or a .torrent file for one request; Manual label; seeds once finished, removed if cancelled while downloading)** → [phase3/manual-torrent-download.md](phase3/manual-torrent-download.md) - **qBittorrent integration (torrents)** → [phase3/qbittorrent.md](phase3/qbittorrent.md) - **qBittorrent torrent IDs (hybrid v1+v2 torrents, base32 magnets)** → [phase3/qbittorrent.md](phase3/qbittorrent.md) - **qBittorrent finished in the incomplete folder (30 s relocation grace, "didn't move it" warning, writable save path, #520)** → [phase3/qbittorrent.md](phase3/qbittorrent.md#completion--relocation-grace) - **SABnzbd integration (Usenet/NZB)** → [phase3/sabnzbd.md](phase3/sabnzbd.md) - **SABnzbd duplicate NZBs, retried adds after a timeout** → [phase3/sabnzbd.md](phase3/sabnzbd.md#duplicate-nzbs-and-retried-adds-329) - **File organization, seeding** → [phase3/file-organization.md](phase3/file-organization.md) - **Post-organize cleanup safety (delete guard, remove-after-processing gate)** → [phase3/file-organization.md](phase3/file-organization.md#post-organize-cleanup-safety) - **Verified import (atomic copy, placement records, delete only what reached the library)** → [phase3/file-organization.md](phase3/file-organization.md#verified-import-delete-only-what-reached-the-library) - **Custom M4B tags (ASIN, publisher, subtitle, language as iTunes freeform `----` atoms), tagged MP4 faststart** → [phase3/file-organization.md](phase3/file-organization.md#mp4-freeform-tags) - **Tagging changed an M4B's chapters (zero-length chapters, cover + chapters, ffmpeg 9.0.2), chapter guard (#511)** → [phase3/file-organization.md](phase3/file-organization.md#chapter-guard-511) - **ffmpeg 9 movie timescale, `-movie_timescale 1000`, chapters over 487 s with a cover, checking a file's chapter track (#511)** → [phase3/file-organization.md](phase3/file-organization.md#mp4-movie-timescale-511) - **Chapter merging (auto-merge to M4B)** → [features/chapter-merging.md](features/chapter-merging.md) - **Hard links instead of copies, metadata.opf instead of tags (Audiobookshelf File placement / Metadata, #68)** → [features/library-placement.md](features/library-placement.md) - **Merged chapter names: embedded "Chapter N" tags kept after an intro, repeated tags fall back to numbering (#509)** → [features/chapter-merging.md](features/chapter-merging.md#fixed-issues) - **Multi-disc (CD1/Disc 1) folders: disc names, import order, disc/track tags, Manual/Bulk Import, in-place stop** → [features/multi-disc-folders.md](features/multi-disc-folders.md) ## Background Jobs - **Bull queue, processors, retry logic** → [backend/services/jobs.md](backend/services/jobs.md) - **Scheduled/recurring jobs (cron)** → [backend/services/scheduler.md](backend/services/scheduler.md) - **Startup initialization (instrumentation hook, /api/init, single-process rule)** → [backend/services/scheduler.md](backend/services/scheduler.md#startup-initialization) - **Job types:** search, download monitor, organize, Plex scan, cleanup, retries ## Logging - **Centralized logging (RMABLogger)** → [backend/services/logging.md](backend/services/logging.md) - **LOG_LEVEL configuration** → [backend/services/logging.md](backend/services/logging.md) - **Job-aware database persistence** → [backend/services/logging.md](backend/services/logging.md) ## Notifications - **Notification backends (Discord, Pushover)** → [backend/services/notifications.md](backend/services/notifications.md) - **Event types, triggers, message formatting** → [backend/services/notifications.md](backend/services/notifications.md) - **Notification settings UI** → [settings-pages.md](settings-pages.md) ## Frontend Components - **Component catalog (cards, badges, forms)** → [frontend/components.md](frontend/components.md) - **RequestCard, StatusBadge, ProgressBar** → [frontend/components.md](frontend/components.md) - **Pages: home, search, requests, profile** → [frontend/components.md](frontend/components.md) - **Dark mode, theme switch (System / Light / Dark), `dark:` variant, no-flash script** → [frontend/components.md](frontend/components.md#theme-switch) - **Home page sections (per-user, configurable)** → [features/home-sections.md](features/home-sections.md) ## Library View - **Library page (/library) and GET /api/library (list + live mode), merge rule, gating, filters/facets, row snapshot and memo caches** → [features/library-view.md](features/library-view.md) ## BookDate (AI Recommendations) - **AI-powered recommendations, swipe interface** → [features/bookdate.md](features/bookdate.md) - **Configuration, OpenAI/Claude integration** → [features/bookdate.md](features/bookdate.md) - **Library scopes (full, rated, favorites)** → [features/bookdate.md](features/bookdate.md) - **Pick my favorites (book selection modal)** → [features/bookdate.md](features/bookdate.md) - **Setup wizard integration, settings** → [features/bookdate.md](features/bookdate.md) - **Card stack animations (3-card stack, swipe animations)** → [features/bookdate-animations.md](features/bookdate-animations.md) - **Library thumbnail caching** → [features/library-thumbnail-cache.md](features/library-thumbnail-cache.md) ## Admin Features - **Dashboard (metrics, downloads, requests)** → [admin-dashboard.md](admin-dashboard.md) - **System logs (filters, search, pagination, /api/admin/logs)** → [admin-dashboard.md](admin-dashboard.md) - **Bulk import (scan folders, match Audible, batch import)** → [features/bulk-import.md](features/bulk-import.md) - **Change a Bulk Import row's match (search or ASIN), import refusals (#189, #588)** → [features/bulk-import.md](features/bulk-import.md) - **Jobs management UI** → [backend/services/scheduler.md](backend/services/scheduler.md) - **Request deletion (soft delete, seeding awareness, library delete guard, files kept reason)** → [admin-features/request-deletion.md](admin-features/request-deletion.md) - **Reported issues: Replace (who the replacement request belongs to, #571)** → [admin-features/request-deletion.md](admin-features/request-deletion.md#reported-issue-replace) - **Shared torrent rule (who keeps a torrent several requests use, and until when)** → [admin-features/request-deletion.md](admin-features/request-deletion.md#shared-torrent-holds) - **Request cancel (stops the download, cancelled-download cleanup pass, token cancel route)** → [admin-features/request-cancel.md](admin-features/request-cancel.md) - **Bulk request actions (select requests in the admin table; approve, deny, cancel, delete one at a time; in-library skip)** → [admin-features/bulk-request-actions.md](admin-features/bulk-request-actions.md) - **Request approval system, auto-approve settings** → [admin-features/request-approval.md](admin-features/request-approval.md) - **Release blocklist (auto-block failed releases, /admin/blocklist)** → [admin-features/release-blocklist.md](admin-features/release-blocklist.md) ## Fixes & Improvements - **File hash-based library matching (ABS)** → [fixes/file-hash-matching.md](fixes/file-hash-matching.md) - **Accurate ASIN matching for RMAB-organized content** → [fixes/file-hash-matching.md](fixes/file-hash-matching.md) ## Deployment - **Docker Compose setup (multi-container)** → [deployment/docker.md](deployment/docker.md) - **Unified container (all-in-one)** → [deployment/unified.md](deployment/unified.md) - **Image build stages, runtime image contents, Prisma CLI in the image, build guards** → [deployment/unified.md](deployment/unified.md#dockerfile-structure) - **Container stop, app/job queue shutdown (SIGTERM, 3.5 s drain, HTTP keep-alive drain, jobs left for retry), PostgreSQL clean shutdown, stop_grace_period ("database system was not properly shut down")** → [deployment/unified.md](deployment/unified.md#shutdown-sequence), [backend/services/jobs.md](backend/services/jobs.md#shutdown-and-cut-jobs) - **Environment variables, volumes** → [deployment/docker.md](deployment/docker.md) - **TLS errors after upgrading to Node 24 (`dh key too small`, `EE certificate key too weak`, `Issuer.discover() failed.`, SABnzbd/NZBGet "SSL/TLS certificate error")** → [deployment/unified.md](deployment/unified.md#tls-errors-after-upgrading-to-node-24) - **Volume mapping (download clients)** → [deployment/volume-mapping.md](deployment/volume-mapping.md) - **Database setup (Prisma), migrations** → [deployment/docker.md](deployment/docker.md) - **CI workflows (GitHub Actions), tag-only image publishing, action SHA pins** → [deployment/ci-workflows.md](deployment/ci-workflows.md) ## Testing - **Backend unit test framework, scripts** [testing.md](testing.md) - **E2E harness (disposable Docker stack, fake-arr, Playwright, self-gate, preview)** → [testing/e2e-harness.md](testing/e2e-harness.md) ## Feature-Specific Lookups **"How do I add a new audiobook?"** → [integrations/audible.md](integrations/audible.md) (scraping), [phase3/README.md](phase3/README.md) (automation) **"How do I configure multiple download clients?"** → [phase3/download-clients.md](phase3/download-clients.md) **"A torrent already in my client was deleted" / "Does RMAB remove torrents it didn't add?"** → [phase3/download-clients.md](phase3/download-clients.md#torrent-ownership-423) (ownership rule, probe, known limits), [backend/services/scheduler.md](backend/services/scheduler.md) (cleanup_seeded_torrents), [admin-features/request-deletion.md](admin-features/request-deletion.md) **"How do I give a request a torrent by hand (magnet or .torrent file)?"** → [phase3/manual-torrent-download.md](phase3/manual-torrent-download.md) **"How do torrent downloads work?"** → [phase3/qbittorrent.md](phase3/qbittorrent.md), [backend/services/jobs.md](backend/services/jobs.md) **"How do Usenet/NZB downloads work?"** → [phase3/sabnzbd.md](phase3/sabnzbd.md), [phase3/download-clients.md](phase3/download-clients.md), [backend/services/jobs.md](backend/services/jobs.md) **"Can I use both qBittorrent and SABnzbd?"** → [phase3/download-clients.md](phase3/download-clients.md) **"How do I use NZBGet instead of SABnzbd?"** → [phase3/download-clients.md](phase3/download-clients.md) **"How do I use Transmission instead of qBittorrent?"** → [phase3/download-clients.md](phase3/download-clients.md) **"How do I set different download paths per client?"** → [phase3/download-clients.md](phase3/download-clients.md#per-client-custom-download-path) **"How do I test a branch end to end without touching my own Docker setup?"** → [testing/e2e-harness.md](testing/e2e-harness.md) **"How does the Library page work?"** → [features/library-view.md](features/library-view.md) **"How does Plex matching work?"** → [integrations/plex.md](integrations/plex.md) **"How does e-book support work?"** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md) **"How do I enable e-book downloads?"** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md), [settings-pages.md](settings-pages.md#e-book-sidecar) **"How do I configure ebook sources (Anna's Archive vs Indexer)?"** → [settings-pages.md](settings-pages.md#e-book-sidecar) **"How does ebook indexer search work?"** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md#flow-indexer-search) **"How do I configure ebook categories per indexer?"** → [settings-pages.md](settings-pages.md#indexer-categories-tabbed) **"How does ebook ranking work?"** → [phase3/ranking-algorithm.md](phase3/ranking-algorithm.md#ebook-torrent-ranking) **"What happens when I delete an ebook request?"** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md#delete-behavior) **"Why do ebook requests have an orange badge?"** → [integrations/ebook-sidecar.md](integrations/ebook-sidecar.md#ui-representation) **"How do scheduled jobs work?"** → [backend/services/scheduler.md](backend/services/scheduler.md) **"How do I configure external services?"** → [setup-wizard.md](setup-wizard.md), [settings-pages.md](settings-pages.md) **"What's the database schema?"** → [backend/database.md](backend/database.md) **"How does authentication work?"** → [backend/services/auth.md](backend/services/auth.md) **"How do I change my password?"** → [backend/services/auth.md](backend/services/auth.md) (local users only - accessed via user menu in header) **"Local admin can't log in / 'Invalid username or password' with correct credentials"** → [admin-features/credential-recovery.md](admin-features/credential-recovery.md) **"How do I recover from a lost CONFIG_ENCRYPTION_KEY?"** → [admin-features/credential-recovery.md](admin-features/credential-recovery.md) **"How do I delete requests?"** → [admin-features/request-deletion.md](admin-features/request-deletion.md) **"Can I delete or cancel many requests at once?" / "Why did deleted requests come back?"** → [admin-features/bulk-request-actions.md](admin-features/bulk-request-actions.md) (page selection, skip rule, shelves and watches re-request deleted ones) **"Does cancelling a request stop its download?" / "Can an API token cancel a request?"** → [admin-features/request-cancel.md](admin-features/request-cancel.md) (partial removed, finished seeds first, cleanup pass for post-upgrade cancels; `POST /api/requests/:id/cancel`), [backend/services/api-tokens.md](backend/services/api-tokens.md) **"How do I approve/deny user requests?"** → [admin-features/request-approval.md](admin-features/request-approval.md) **"How do I enable auto-approve for requests?"** → [admin-features/request-approval.md](admin-features/request-approval.md) **"How does the release blocklist work?"** → [admin-features/release-blocklist.md](admin-features/release-blocklist.md) **"Why does the same bad release keep getting re-downloaded?"** → [admin-features/release-blocklist.md](admin-features/release-blocklist.md) (it shouldn't anymore — auto-blocked on permanent failure) **"Why didn't shelf sync / a watch re-request my failed or cancelled book?"** → [admin-features/release-blocklist.md](admin-features/release-blocklist.md#automatic-re-requests-409) (cancelled: never; a failure that blocked nothing: 1, 3, 7, 14, then every 30 days; pressing Request retries at once) **"I deleted a book from the library; why is its request failed / why wasn't it re-downloaded?"** → [backend/services/scheduler.md](backend/services/scheduler.md) (plex_library_scan: files gone → `failed` "Removed from library", request it again by hand; never re-requested automatically, #214) **"Why did RMAB grab a different release after a failed download?" / "Why wasn't a failed release blocked?"** → [admin-features/release-blocklist.md](admin-features/release-blocklist.md#next-release-after-a-client-failure-332) (automatic grabs try the next-ranked release, at most 3 in a row; full disk, permissions and missing-data failures are never blocked) **"How do I unblock a release?"** → [admin-features/release-blocklist.md](admin-features/release-blocklist.md) (admin → /admin/blocklist → Unblock, or chip on the request row) **"How does the admin book info modal work?"** → [admin-features/request-approval.md](admin-features/request-approval.md#ui-features), [frontend/components.md](frontend/components.md#component-apis) **"How do I customize audiobook folder organization?"** → [settings-pages.md](settings-pages.md#audiobook-organization-template), [phase3/file-organization.md](phase3/file-organization.md#target-structure) **"How do I deploy?"** → [deployment/docker.md](deployment/docker.md) (multi-container), [deployment/unified.md](deployment/unified.md) (all-in-one) **"How do I use the unified container?"** → [deployment/unified.md](deployment/unified.md) **"Download client / OIDC / Plex stopped connecting over HTTPS after the upgrade"** → [deployment/unified.md](deployment/unified.md#tls-errors-after-upgrading-to-node-24) (Node 24 refuses weak TLS keys) **"Why can't RMAB find my downloaded files?"** → [deployment/volume-mapping.md](deployment/volume-mapping.md) **"How do I set up volume mapping for qBittorrent/Transmission/SABnzbd/NZBGet?"** → [deployment/volume-mapping.md](deployment/volume-mapping.md) **"OAuth redirects to localhost / PUBLIC_URL not working"** → [backend/services/environment.md](backend/services/environment.md) **"What environment variables do I need?"** → [backend/services/environment.md](backend/services/environment.md) **"How does chapter merging work?"** → [features/chapter-merging.md](features/chapter-merging.md) **"Can imports hard-link instead of copy (save disk, keep seeding)?" / "Why was my book copied, not linked?"** → [features/library-placement.md](features/library-placement.md) **"How does logging work?"** → [backend/services/logging.md](backend/services/logging.md) **"How do BookDate card stack animations work?"** → [features/bookdate-animations.md](features/bookdate-animations.md) **"How do I limit each Audiobookshelf user to the books they requested?"** → [features/requester-tags.md](features/requester-tags.md) **"How do I hide adult books from kids in Audiobookshelf?"** → [features/explicit-flag.md](features/explicit-flag.md) **"How does Audiobookshelf integration work?"** → `src/lib/services/audiobookshelf/api.ts`, `src/lib/services/library/AudiobookshelfLibraryService.ts` **"How do I use OIDC/Authentik/Keycloak?"** → [backend/services/auth.md](backend/services/auth.md) **"How do I switch from Plex to Audiobookshelf?"** → Setup wizard (re-run setup with different backend mode) **"How does library thumbnail caching work?"** → [features/library-thumbnail-cache.md](features/library-thumbnail-cache.md) **"Why do BookDate library books show placeholders?"** → [features/library-thumbnail-cache.md](features/library-thumbnail-cache.md) **"How does file hash matching work?"** → [fixes/file-hash-matching.md](fixes/file-hash-matching.md) **"Why is ABS matching the wrong book?"** → [fixes/file-hash-matching.md](fixes/file-hash-matching.md) (file hash prevents false positives) **"How do I customize my home page?"** → [features/home-sections.md](features/home-sections.md) **"How do Audible categories work?"** → [features/home-sections.md](features/home-sections.md) **"Why does a home section still show its old books after a refresh?"** → [features/home-sections.md](features/home-sections.md#refresh-processor-unified-storage) (a fetch with no books keeps the previous list; empty category scrapes fall back to the catalog API, [integrations/audible.md](integrations/audible.md#nightly-refresh-html--htmlclient-baseurl-wwwaudibletld)) **"How do I add category sections to the home page?"** → [features/home-sections.md](features/home-sections.md) **"Does a deleted user's shelf or watched list still create requests?"** → No (#504): [backend/services/goodreads-sync.md](backend/services/goodreads-sync.md#deleted-users-504), [features/watched-lists.md](features/watched-lists.md), [backend/services/scheduler.md](backend/services/scheduler.md) (find_missing_ebooks) **"How do Goodreads shelves work?"** → [backend/services/goodreads-sync.md](backend/services/goodreads-sync.md) **"Why does my Goodreads shelf return 404 / not sync?"** → Goodreads ended shelf RSS feeds (#514): [backend/services/goodreads-sync.md](backend/services/goodreads-sync.md#feeds-ended-514) **"How do Hardcover shelves work?"** → [backend/services/hardcover-sync.md](backend/services/hardcover-sync.md) **"How do I add a new shelf provider?"** → [backend/services/goodreads-sync.md](backend/services/goodreads-sync.md#adding-a-new-provider) **"How does the shelf sync core work?"** → [backend/services/goodreads-sync.md](backend/services/goodreads-sync.md#shared-sync-core) **"How does bulk import work?"** → [features/bulk-import.md](features/bulk-import.md) **"How do I import multiple audiobooks at once?"** → [features/bulk-import.md](features/bulk-import.md) **"How does the bulk import scanner detect audiobooks?"** → [features/bulk-import.md](features/bulk-import.md) **"How are books in CD1/Disc 1 folders imported and ordered?"** → [features/multi-disc-folders.md](features/multi-disc-folders.md) **"Why is a series page blank / showing no books, then fine after a refresh?"** → [integrations/audible.md](integrations/audible.md#series-page-dual-layout) (Audible A/B-serves two layouts; parsers handle both) **"Why is a book's series line missing, or a request saved without a series?"** → [integrations/audible.md](integrations/audible.md#fixed-issues) (series fill from the Audible catalog when Audnexus has none; 15 min pause after a catalog outage (429, 401/403, 5xx, timeout, network), 24 h cache) **"Why does search say 'N in other languages hidden', or did a BookDate / shelf book get no match?"** → [integrations/audible-language-filter.md](integrations/audible-language-filter.md) (admin language filter: other-language editions hidden, translated titles become no-match) **"Why does a request or interactive search say 'N of M indexer searches failed'?"** → [phase3/prowlarr.md](phase3/prowlarr.md#failed-searches-522) (failed Prowlarr queries counted, warn lines in System Logs, `searchFailures` in interactive responses) **"Why does series search say it couldn't get results from Audible, or show series without a rating or book count?"** → [integrations/audible-series-search.md](integrations/audible-series-search.md) (catalog keyword + batch calls, 502 when Audible doesn't answer, counts only from the catalog, no series rating on search cards)