# Deploy ReadMeABook with Easypanel

URL: /templates/readmeabook

ReadMeABook is a self-hosted audiobook request and automation platform—like Radarr/Sonarr + Overseerr for audiobooks. Integrates with Plex or Audiobookshelf, supports torrents (qBittorrent) and Usenet (SABnzbd), Prowlarr for search. Features multi-file chapter merging, e-book sidecars, AI recommendations (BookDate), and admin approval workflows. Includes PostgreSQL and Redis.

## Installation notes

After deployment, access the web UI and run the setup wizard. Set PUBLIC_URL to your domain (e.g. `https://readmeabook.yourdomain.com`) for OAuth (Plex/OIDC). Mount downloads and media volumes for audiobook storage. Connect to Plex or Audiobookshelf, and configure qBittorrent/SABnzbd for downloads.

## Benefits

### Audiobook Automation

Request, search, download, and organize audiobooks automatically

### Plex & Audiobookshelf

Integrates with popular media servers

### All-in-One

PostgreSQL and Redis included; no external database required

### Self-Hosted

Full control over your audiobook library

## Features

### Torrent & Usenet

qBittorrent and SABnzbd support

### Prowlarr Integration

Search across indexers via Prowlarr

### AI Recommendations

BookDate with Tinder-style swipe (OpenAI, Claude, local models)

### Multi-User & Admin

Request approval workflows

### Chapter Merging

Multi-file chapter merging, e-book sidecar (EPUB/PDF)

## Configuration

- `appServiceName` (App Service Name, required): readmeabook

- `appServiceImage` (App Service Image, required): ghcr.io/kikootwo/readmeabook:1.1.8

- `puid` (User ID (PUID)): 1000 — Host user ID for file ownership

- `pgid` (Group ID (PGID)): 1000 — Host group ID for file ownership

- `publicUrl` (Public URL): Set during installation — Required for OAuth. e.g. https://readmeabook.yourdomain.com

## Services

- readmeabook: app (ghcr.io/kikootwo/readmeabook:1.1.8)

## Resources

- [GitHub](https://github.com/kikootwo/readmeabook)

- [Documentation](https://github.com/kikootwo/readmeabook/tree/main/documentation)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/readmeabook)