selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
librarr logo

Self-host librarr

v1.4.1

Search and download manager for books, audiobooks, and manga

ReleaseOpen SourceMIT
Updated8 hours ago
LanguageGo
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
295
Port
5050 (HTTP web UI and API)
Docker
ghcr.io/jeremiahm37/librarr
Install with Docker Compose
Parallel indexer search with confidence scoringUnified library view across ebooks, audiobooks, and mangaWanted list with state, quality profile, and scheduler decisionsSettings: scheduler, quality profile editor with cutoff, and monitored authors

What is librarr?

Librarr is a self-hosted search and download manager for books, audiobooks, and manga written in Go. It searches configured indexers (Prowlarr, OPDS catalogs, public APIs, Anna's Archive, web-novel sites, and more) in parallel, scores results with a 0-100 confidence breakdown, and manages downloads via qBittorrent, Transmission, or SABnzbd. Wanted items get quality profiles with format ranking and cutoffs; the scheduler automatically searches and upgrades until the cutoff is met. It auto-imports into Calibre, Audiobookshelf, Kavita, or Komga, supports author monitoring with Open Library work keys, series auto-complete, Goodreads/StoryGraph CSV import, and provides Torznab and OPDS 1.2 APIs for integration with Prowlarr, Readarr, and e-reader apps. The UI is a mobile-responsive single-page app with dark theme, multi-user auth (bcrypt, TOTP 2FA, OIDC/SSO), API keys, rate limiting, Prometheus metrics, and webhook notifications (Discord, generic). It runs as a single ~17 MB static binary with pure-Go SQLite (~14 MB idle RSS), available via Docker (ghcr.io/jeremiahm37/librarr) or direct binary download for Linux, macOS, and Windows on amd64, arm64, and armv7.

Should you self-host librarr?

librarr scores 50/100 on selfhost.directory (how scoring works) and ranks #8 of 12 in Book Management. It has 295 GitHub stars.

It shipped 13 stable releases in the past year. The latest, v1.4.1, came out on 21 September 2026. New versions land roughly every 8 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is SoulSync (67/100, 2 321 stars). It scores higher overall, so compare the two before you pick. See librarr vs SoulSync side by side.

Features

  • Author monitoring
  • Automatic upgrades
  • Automatic wanted list scheduler
  • Backup and Restore
  • File organization and auto-import
  • Goodreads/StoryGraph CSV import
  • Multi-user Authentication
  • OPDS 1.2 feed
  • Parallel multi-source search
  • Prometheus Metrics
  • Quality profiles with format ranking
  • Request/approval workflow
  • Series auto-complete
  • Torznab/Newznab API
  • Webhook Notifications

librarr README

How to install librarr

Install librarr with Docker Compose

Docker and Docker Compose
Environment variables
AUTH_USERNAME, AUTH_PASSWORD, API_KEY, QB_URL, QB_USER, QB_PASS, PROWLARR_URL, PROWLARR_API_KEY, and many more

services: librarr: image: ghcr.io/jeremiahm37/librarr:latest ports: - "5050:5050" volumes: - ./data:/data - /path/to/ebooks:/books/ebooks - /path/to/audiobooks:/books/audiobooks - /path/to/manga:/books/manga environment: - AUTH_USERNAME=admin - AUTH_PASSWORD=changeme - API_KEY=your-api-key-here - QB_URL=http://qbittorrent:8080 - QB_USER=admin - QB_PASS=changeme - PROWLARR_URL=http://prowlarr:9696 - PROWLARR_API_KEY=your-prowlarr-api-key restart: unless-stopped

docker compose up -d

Recommended installation method

librarr releases & version history

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…