Skip to content
narratorr

First Run Setup

After installing Narratorr, you’ll configure the essentials to start searching and downloading audiobooks.

  1. Set up authentication

    Navigate to Settings > Security. Choose an authentication mode:

    • Forms (recommended) — creates a login page with session-based auth
    • Basic — HTTP Basic Auth prompted by the browser
    • None — no auth (only if Narratorr is on an isolated network)

    Create a username and password. See Security & Auth for details.

  2. Configure your library path

    Go to Settings > Library. Set the path where Narratorr should store your audiobooks. In Docker, this is /audiobooks by default (mapped to a host directory via volumes).

  3. Add an indexer

    Go to Settings > Indexers and add at least one source to search:

    • Prowlarr import — if you already use Prowlarr, sync your indexers in one step
    • Torznab — for torrent indexers via Jackett or Prowlarr
    • Newznab — for Usenet indexers
    • AudioBookBay — direct scraper (may require FlareSolverr)

    Click Test to verify the connection. See Indexers for per-type setup.

  4. Add a download client

    Go to Settings > Download Clients and add your client:

    Click Test to verify the connection. See Download Clients for per-type setup.

  5. Search for your first audiobook

    Go to the Search page. Type an author or title and hit search. Narratorr queries all your configured indexers and shows combined results.

  6. Add a book to your library

    From the search results, select a book to view its details. Click Add to Library to track it.

  7. Grab a release

    Browse the available releases for your book. Click Grab on the one you want — Narratorr sends it to your download client.

  8. Monitor the download

    Check the Activity page to watch download progress. Once the download completes, Narratorr automatically imports it into your library folder using your configured folder format.