Grimmory Self Hosted Library

If you're running a personal book server, this gives Claude the context to help you deploy and configure Grimmory, a self-hosted library manager that handles EPUBs, PDFs, comics, and syncs with Kobo devices. The skill covers the full Docker Compose setup with MariaDB, the bookdrop auto-import folder that watches for new files and fetches metadata from Google Books, and the network storage mode for NFS or SMB mounts. It also includes Java controller patterns and API routes if you're extending the backend. Useful when you want Claude to troubleshoot your docker-compose.yml, explain OPDS catalog endpoints, or help you write a custom import script that talks to the REST API.

skills.sh installs: 1.2K
GitHub stars: 61
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add aradotso/trending-skills --skill grimmory-self-hosted-library --agent claude-code

Installs into .claude/skills of the current project.

Files

Grimmory Self-Hosted Library Manager

Skill by ara.so — Daily 2026 Skills collection.

Grimmory is a self-hosted application (successor to BookLore) for managing your entire book collection. It supports EPUBs, PDFs, MOBIs, AZW/AZW3, and comics (CBZ/CBR/CB7), with a built-in browser reader, annotations, Kobo/OPDS sync, KOReader progress sync, metadata enrichment, and multi-user support.

Installation

Requirements

Docker and Docker Compose

Step 1: Create `.env`

# Application
APP_USER_ID=1000
APP_GROUP_ID=1000
TZ=Etc/UTC

# Database
DATABASE_URL=jdbc:mariadb://mariadb:3306/grimmory
DB_USER=grimmory
DB_PASSWORD=${DB_PASSWORD}

# Storage: LOCAL (default) or NETWORK
DISK_TYPE=LOCAL

# MariaDB
DB_USER_ID=1000
DB_GROUP_ID=1000
MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}
MYSQL_DATABASE=grimmory