Leafmark is a self-hosted, multi-user book tracking application. Add books by scanning ISBNs or searching across six external sources, track reading status and progress, organise your library with tags and series, and follow your reading with yearly challenges and statistics. Every family member keeps their own collection. Sign-in works without a password.
Leafmark ships as a ready-made Docker image, built by GitHub Actions and pushed to the GitHub Container Registry, with a PostgreSQL database. You need a small server, a domain with HTTPS and an SMTP account for sign-in links.
- Create a PostgreSQL resource in Coolify (any Docker Compose host works too).
- Deploy
deploy/docker-compose.coolify.ymlas a "Docker Compose Empty" resource and set the environment variables (Installation und Betrieb). - Open the site, register the first account โ it becomes the admin automatically.
- Search for a book, add it, and start tracking.
Updates are a new image tag; the database is migrated automatically on start. Make a backup of the PostgreSQL resource and the app-storage volume first.
Leafmark searches multiple sources in one query and merges the results by ISBN. Add a book from the results, or fill in the details by hand. Reading progress, covers, tags and series are stored per book; statistics and challenges aggregate across the whole library.
| Part | What for |
|---|---|
| Bรผcher & Import | Add, edit and organise books; import from Goodreads CSV, ZIP backup, Amazon URLs or six book APIs |
| Lesen & Statistik | Reading status, page progress, ratings, series, yearly challenges, charts |
| Anmeldung & Sicherheit | Passkeys, magic links, TOTP 2FA with recovery codes, family accounts |
| Administration | User management, registration control, SMTP and API key settings |
| Installation & Betrieb | Coolify setup, environment variables, updates, backups |
Everything else โ every setting, every import option โ is in the wiki.
Leafmark runs on your own server; your data goes to nobody else, and there is no telemetry. The only outside calls are searches to the book APIs you configure and cover image downloads, both of which you control. There are no passwords to leak by default: sign-in uses passkeys or single-use email links; a traditional password always requires a second factor.
Every change runs through the full test suite against PostgreSQL before an image is built. Please report security issues privately to the maintainer instead of opening a public issue.
Ideas, bug reports and wishes are welcome as an issue.
For developers: PHP 8.5, Laravel 13, PostgreSQL (see phpunit.xml for test database). The repository opens ready to use in the dev container or GitHub Codespaces; docker compose up -d db starts the database, php artisan serve and npm run dev start the app, and php artisan test runs the tests. Architecture and conventions are in CLAUDE.md; the handbook, from which the wiki is generated, describes every feature.
Leafmark is free software under the GNU Affero General Public License v3.0. Anyone may use, adapt and share it at no cost. If you offer a modified version to others over a network, you must make its source code available under the AGPL-3.0 as well.
