COPS

COPS (Calibre OPDS PHP Server) is a lightweight, self-hosted web server that provides access to your Calibre ebook library through a browser or OPDS-compatible e-reader app. Browse, search, and download books without running full Calibre.

Features

• Web Catalog - Browse your Calibre library in a responsive HTML interface
• OPDS Feed - Connect e-readers and mobile apps via the /feed endpoint
• Search - Full-text search across titles, authors, tags, and series
• In-Browser Reading - Read EPUB books directly in the browser
• Download Support - Download books in all formats stored in your Calibre library
• Lightweight - Minimal CPU and RAM requirements, no database server needed
• Mobile Friendly - Responsive design works on phones and tablets

Prerequisites

COPS requires a Calibre metadata.db file and your ebook collection. Mount your Calibre library folder to /books in the container.

First Access

Open your domain to see the COPS catalog. If no books appear, verify your Calibre library is correctly mounted to /books.

What You Can Do After Deployment

1. Open your domain — browse the COPS web catalog
2. Search for books — use the search bar to find specific titles or authors
3. Download books — click on any book to download in available formats
4. Read in browser — open EPUB files directly in the web reader
5. Connect e-readers — point your OPDS app to https://your-domain/feed
6. Customize — edit /config/local.php for display preferences

Volumes

• /config — COPS configuration files
• /books — Calibre library (must contain metadata.db)

License

GPL-2.0 — GitHub