> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augustin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Chaptarr

# Chaptarr

Ebook and audiobook collection manager — a fork of the retired Readarr that handles both in one instance. Replaces the two Bookshelf instances.

Runs on **i3 (`debian-1`)** as a **Swarm service** (`chaptarr_chaptarr`) on the `swarm` overlay. Image `robertlordhood/chaptarr:latest` (v0.9.439), port 8789. The earlier "runs on Pentium, inside the gluetun namespace" description is obsolete.

## URL

| Service  | URL                                                          |
| -------- | ------------------------------------------------------------ |
| Chaptarr | [https://chaptarr.augustin.ai](https://chaptarr.augustin.ai) |

## How It Works

```
Hardcover import list → Chaptarr → Prowlarr (8 indexers) → qBittorrent/Gluetun → /media/books/ or /media/audiobooks/
```

* Ebooks: host cron copies new files to the CWA ingest folder → Calibre library (see [Reading Pipeline](../notes/reading-pipeline.md))
* Audiobooks: Audiobookshelf picks them up from `/media/audiobooks/`

## Configuration

* **Metadata server**: `api2.chaptarr.com` (Settings → Development). The default `api.chaptarr.com` has SSL issues.
* **Download client**: qBittorrent at `gluetun:8085` (reached over the `swarm` overlay by service DNS — Chaptarr is no longer inside gluetun's namespace, so it is not `localhost`).
* **Indexers**: Prowlarr at `prowlarr:9696` (overlay DNS).
* **Root folders**: `/media/books` (ebooks), `/media/audiobooks` (audiobooks).
* **Import list**: Hardcover Library — imports Want to Read + Currently Reading.

## Management

No official CLI. API at `http://chaptarr:8789/api/v1` (overlay) with `X-Api-Key` from `chaptarr/config/config.xml`. `curl` is **not** installed in the container — use `wget -qO- --header="X-Api-Key: …"` for in-container API calls.

## Architecture

```
chaptarr.augustin.ai → Cloudflare tunnel → Traefik (i3, Swarm provider) → chaptarr_chaptarr (overlay)
```

Routed by Traefik's Swarm provider via `deploy.labels` in `chaptarr/compose.yaml`.

## Status

Several stages are currently broken (Hardcover import list returns nothing; `NO_MATCH_HOLY_GRAIL` import failures; indexer throttling). See the [Known Issues](../notes/reading-pipeline.md#known-issues) section of the Reading Pipeline doc.