# yaml-language-server: $schema=https://schema.zeabur.app/template.json apiVersion: zeabur.com/v1 kind: Template metadata: name: COPS spec: description: | COPS (Calibre OPDS PHP Server) is a lightweight web-based interface to browse and download books from a Calibre library. It provides both an HTML catalog and OPDS feed for e-reader devices, with search, filtering, and direct in-browser epub reading. coverImage: https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/cops-icon.png icon: https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/cops-icon.png variables: - key: PUBLIC_DOMAIN type: DOMAIN name: Domain description: The domain to access COPS tags: - Tool - Media readme: | # 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](https://github.com/seblucas/cops) services: - name: cops icon: https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/cops-icon.png template: PREBUILT_V2 spec: source: image: linuxserver/cops:4.3.1 ports: - id: web port: 80 type: HTTP volumes: - id: config dir: /config - id: books dir: /books env: PGID: default: "1000" PUID: default: "1000" healthCheck: type: HTTP port: web http: path: / domainKey: PUBLIC_DOMAIN localization: es-ES: description: | COPS (Calibre OPDS PHP Server) es una interfaz web ligera para navegar y descargar libros de una biblioteca Calibre. Proporciona un catalogo HTML y un feed OPDS para dispositivos de lectura, con busqueda, filtrado y lectura de EPUB en el navegador. variables: - key: PUBLIC_DOMAIN type: STRING name: Dominio description: El dominio para acceder a COPS readme: | # COPS COPS (Calibre OPDS PHP Server) es un servidor web ligero y autoalojado que proporciona acceso a su biblioteca de libros electronicos Calibre a traves del navegador o aplicaciones de lectura compatibles con OPDS. Navegue, busque y descargue libros sin ejecutar Calibre completo. ## Requisitos previos COPS requiere un archivo `metadata.db` de Calibre y su coleccion de libros electronicos. Monte la carpeta de su biblioteca Calibre en `/books` del contenedor. ## Primer acceso Abra su dominio para ver el catalogo COPS. Si no aparecen libros, verifique que su biblioteca Calibre este correctamente montada en `/books`. ## Que puede hacer despues del despliegue 1. Abra su dominio — navegue por el catalogo web COPS 2. Busque libros — use la barra de busqueda para encontrar titulos o autores especificos 3. Descargue libros — haga clic en cualquier libro para descargar en los formatos disponibles 4. Lea en el navegador — abra archivos EPUB directamente en el lector web 5. Conecte lectores electronicos — apunte su app OPDS a `https://su-dominio/feed` 6. Personalice — edite `/config/local.php` para ajustar las preferencias de visualizacion ## Licencia GPL-2.0 — [GitHub](https://github.com/seblucas/cops) id-ID: description: | COPS (Calibre OPDS PHP Server) adalah antarmuka web ringan untuk menjelajahi dan mengunduh buku dari perpustakaan Calibre. Menyediakan katalog HTML dan feed OPDS untuk perangkat e-reader, dengan pencarian, penyaringan, dan pembacaan EPUB langsung di browser. variables: - key: PUBLIC_DOMAIN type: STRING name: Domain description: Domain untuk mengakses COPS readme: | # COPS COPS (Calibre OPDS PHP Server) adalah server web ringan self-hosted yang menyediakan akses ke perpustakaan ebook Calibre melalui browser atau aplikasi e-reader yang kompatibel dengan OPDS. Jelajahi, cari, dan unduh buku tanpa menjalankan Calibre penuh. ## Prasyarat COPS memerlukan file `metadata.db` Calibre dan koleksi ebook Anda. Mount folder perpustakaan Calibre ke `/books` di container. ## Akses Pertama Buka domain Anda untuk melihat katalog COPS. Jika buku tidak muncul, pastikan perpustakaan Calibre telah di-mount dengan benar ke `/books`. ## Yang Dapat Dilakukan Setelah Deploy 1. Buka domain — jelajahi katalog web COPS 2. Cari buku — gunakan bilah pencarian untuk menemukan judul atau penulis tertentu 3. Unduh buku — klik buku apa pun untuk mengunduh dalam format yang tersedia 4. Baca di browser — buka file EPUB langsung di pembaca web 5. Hubungkan e-reader — arahkan aplikasi OPDS ke `https://domain-anda/feed` 6. Kustomisasi — edit `/config/local.php` untuk preferensi tampilan ## Lisensi GPL-2.0 — [GitHub](https://github.com/seblucas/cops) ja-JP: description: | COPS（Calibre OPDS PHP Server）は Calibre ライブラリの書籍を閲覧・ダウンロードするための軽量な Web インターフェースです。HTML カタログと OPDS フィードを提供し、検索、フィルタリング、ブラウザ内での EPUB 閲覧に対応しています。 variables: - key: PUBLIC_DOMAIN type: STRING name: ドメイン description: COPS にアクセスするためのドメイン readme: | # COPS COPS（Calibre OPDS PHP Server）は軽量なセルフホスト型 Web サーバーで、ブラウザや OPDS 対応の電子書籍リーダーから Calibre の電子書籍ライブラリにアクセスできます。完全な Calibre を実行せずに書籍の閲覧、検索、ダウンロードが可能です。 ## 前提条件 COPS には Calibre の `metadata.db` ファイルと電子書籍コレクションが必要です。Calibre ライブラリフォルダをコンテナの `/books` にマウントしてください。 ## 初回アクセス ドメインを開いて COPS カタログを表示します。書籍が表示されない場合は、Calibre ライブラリが `/books` に正しくマウントされているか確認してください。 ## デプロイ後にできること 1. ドメインを開く — COPS Web カタログを閲覧 2. 書籍を検索 — 検索バーで特定のタイトルや著者を検索 3. 書籍をダウンロード — 書籍をクリックして利用可能なフォーマットでダウンロード 4. ブラウザで読む — Web リーダーで EPUB ファイルを直接開く 5. 電子書籍リーダーを接続 — OPDS アプリを `https://ドメイン/feed` に設定 6. カスタマイズ — `/config/local.php` を編集して表示設定を調整 ## ライセンス GPL-2.0 — [GitHub](https://github.com/seblucas/cops) ko-KR: description: | COPS(Calibre OPDS PHP Server)는 Calibre 도서관에서 전자책을 검색하고 다운로드하기 위한 경량 웹 인터페이스입니다. HTML 카탈로그와 OPDS 피드를 제공하며 검색, 필터링, 브라우저 내 EPUB 읽기를 지원합니다. variables: - key: PUBLIC_DOMAIN type: STRING name: 도메인 description: COPS에 접속할 도메인 readme: | # COPS COPS(Calibre OPDS PHP Server)는 브라우저나 OPDS 호환 전자책 리더 앱을 통해 Calibre 전자책 도서관에 접근할 수 있는 경량 셀프 호스팅 웹 서버입니다. 전체 Calibre를 실행하지 않고도 도서를 검색, 탐색, 다운로드할 수 있습니다. ## 전제 조건 COPS에는 Calibre의 `metadata.db` 파일과 전자책 컬렉션이 필요합니다. Calibre 도서관 폴더를 컨테이너의 `/books`에 마운트하세요. ## 첫 접속 도메인을 열어 COPS 카탈로그를 확인합니다. 도서가 표시되지 않으면 Calibre 도서관이 `/books`에 올바르게 마운트되었는지 확인하세요. ## 배포 후 할 수 있는 것 1. 도메인 열기 — COPS 웹 카탈로그 검색 2. 도서 검색 — 검색 바로 특정 제목이나 저자 찾기 3. 도서 다운로드 — 도서를 클릭하여 사용 가능한 형식으로 다운로드 4. 브라우저에서 읽기 — 웹 리더에서 EPUB 파일을 직접 열기 5. 전자책 리더 연결 — OPDS 앱을 `https://도메인/feed`로 설정 6. 사용자 정의 — `/config/local.php`를 편집하여 표시 설정 조정 ## 라이선스 GPL-2.0 — [GitHub](https://github.com/seblucas/cops) th-TH: description: | COPS (Calibre OPDS PHP Server) เป็นอินเทอร์เฟซเว็บขนาดเบาสำหรับเรียกดูและดาวน์โหลดหนังสือจากไลบรารี Calibre ให้บริการแคตตาล็อก HTML และฟีด OPDS สำหรับอุปกรณ์อ่าน e-book พร้อมการค้นหา การกรอง และการอ่าน EPUB ในเบราว์เซอร์ variables: - key: PUBLIC_DOMAIN type: STRING name: โดเมน description: โดเมนสำหรับเข้าถึง COPS readme: | # COPS COPS (Calibre OPDS PHP Server) เป็นเว็บเซิร์ฟเวอร์ self-hosted ขนาดเบาที่ให้การเข้าถึงไลบรารี ebook Calibre ผ่านเบราว์เซอร์หรือแอป e-reader ที่รองรับ OPDS เรียกดู ค้นหา และดาวน์โหลดหนังสือโดยไม่ต้องรัน Calibre เต็มรูปแบบ ## ข้อกำหนดเบื้องต้น COPS ต้องการไฟล์ `metadata.db` ของ Calibre และคอลเลกชัน ebook ของคุณ เมาท์โฟลเดอร์ไลบรารี Calibre ไปที่ `/books` ในคอนเทนเนอร์ ## การเข้าถึงครั้งแรก เปิดโดเมนของคุณเพื่อดูแคตตาล็อก COPS หากหนังสือไม่แสดง ตรวจสอบว่าไลบรารี Calibre ถูกเมาท์ไปที่ `/books` อย่างถูกต้อง ## สิ่งที่ทำได้หลังการ Deploy 1. เปิดโดเมน — เรียกดูแคตตาล็อกเว็บ COPS 2. ค้นหาหนังสือ — ใช้แถบค้นหาเพื่อค้นหาชื่อเรื่องหรือผู้เขียนเฉพาะ 3. ดาวน์โหลดหนังสือ — คลิกหนังสือใดก็ได้เพื่อดาวน์โหลดในรูปแบบที่มี 4. อ่านในเบราว์เซอร์ — เปิดไฟล์ EPUB ในตัวอ่านเว็บโดยตรง 5. เชื่อมต่อ e-reader — ชี้แอป OPDS ไปที่ `https://โดเมนของคุณ/feed` 6. ปรับแต่ง — แก้ไข `/config/local.php` สำหรับค่ากำหนดการแสดงผล ## สัญญาอนุญาต GPL-2.0 — [GitHub](https://github.com/seblucas/cops) zh-CN: description: | COPS（Calibre OPDS PHP Server）是一款轻量级的网页界面，用于浏览和下载 Calibre 书库中的电子书。提供 HTML 目录和 OPDS 订阅，支持搜索、筛选及浏览器内直接阅读 EPUB。 variables: - key: PUBLIC_DOMAIN type: STRING name: 域名 description: 访问 COPS 的域名 readme: | # COPS COPS（Calibre OPDS PHP Server）是一款轻量级的自托管网页服务器，通过浏览器或 OPDS 兼容的电子书阅读器访问您的 Calibre 电子书库。无需运行完整的 Calibre 即可浏览、搜索和下载书籍。 ## 前置要求 COPS 需要 Calibre 的 `metadata.db` 文件和您的电子书收藏。将 Calibre 书库文件夹挂载到容器的 `/books` 路径。 ## 首次访问 打开您的域名查看 COPS 目录。如果没有显示书籍，请确认 Calibre 书库已正确挂载到 `/books`。 ## 部署后可以做什么 1. 打开您的域名 — 浏览 COPS 网页目录 2. 搜索书籍 — 使用搜索栏查找特定书名或作者 3. 下载书籍 — 点击任意书籍以下载可用格式 4. 浏览器内阅读 — 直接在网页阅读器中打开 EPUB 文件 5. 连接电子书阅读器 — 将 OPDS 应用指向 `https://您的域名/feed` 6. 自定义 — 编辑 `/config/local.php` 调整显示偏好 ## 许可证 GPL-2.0 — [GitHub](https://github.com/seblucas/cops) zh-TW: description: | COPS（Calibre OPDS PHP Server）是一款輕量級的網頁介面，用於瀏覽和下載 Calibre 書庫中的電子書。提供 HTML 目錄和 OPDS 訂閱，支援搜尋、篩選及瀏覽器內直接閱讀 EPUB。 variables: - key: PUBLIC_DOMAIN type: STRING name: 網域 description: 存取 COPS 的網域 readme: | # COPS COPS（Calibre OPDS PHP Server）是一款輕量級的自架網頁伺服器，透過瀏覽器或 OPDS 相容的電子書閱讀器存取您的 Calibre 電子書庫。無需執行完整的 Calibre 即可瀏覽、搜尋和下載書籍。 ## 前置需求 COPS 需要 Calibre 的 `metadata.db` 檔案和您的電子書收藏。將 Calibre 書庫資料夾掛載到容器的 `/books` 路徑。 ## 首次存取 開啟您的網域查看 COPS 目錄。如果沒有顯示書籍，請確認 Calibre 書庫已正確掛載到 `/books`。 ## 部署後可以做什麼 1. 開啟您的網域 — 瀏覽 COPS 網頁目錄 2. 搜尋書籍 — 使用搜尋列查找特定書名或作者 3. 下載書籍 — 點擊任意書籍以下載可用格式 4. 瀏覽器內閱讀 — 直接在網頁閱讀器中開啟 EPUB 檔案 5. 連接電子書閱讀器 — 將 OPDS 應用程式指向 `https://您的網域/feed` 6. 自訂設定 — 編輯 `/config/local.php` 調整顯示偏好 ## 授權 GPL-2.0 — [GitHub](https://github.com/seblucas/cops)