# Project pack: Komga @ 023ec90

Facts about **Komga** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> Komga is a self-hosted server for your digital comics and books. It scans your folders, organises series with covers and metadata, tracks reading per user, and lets you read in the browser or through apps over OPDS and the Komga API. It is light, stable and runs on small machines.

## Setup path (checked 2026-11-03)
- **Not verified.** Not verified. Check the official install page for a native, desktop or hosted option first; fall back to Docker only if there is none. Upstream install docs are JavaScript-rendered and could not be read as text, so neither a no-Docker path nor a Docker requirement was confirmed.
- Verdict source: https://raw.githubusercontent.com/gotson/komga/HEAD/README.md
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/gotson/komga
- Pinned commit: `023ec905c10a35bbb8e29095420d266cd3adad60`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/gotson/komga/archive/023ec905c10a35bbb8e29095420d266cd3adad60.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://komga.org/
- Licence: **MIT**. Free to use, change and share, even commercially. Keep the original copyright notice.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/gotson/komga bespoke-komga
  cd bespoke-komga
  git checkout --detach 023ec905c10a35bbb8e29095420d266cd3adad60
  # Prepare development requirements and local configuration first.
  ./gradlew bootRun
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  docker run -d --name komga -p 25600:25600 -v komga-config:/config -v /path/to/your/comics:/data gotson/komga
  # then open http://localhost:25600 and create the first user
  ```
- Tools these commands use: Docker for a trial, JDK 21 and Node for development
- Develop: `./gradlew bootRun`
- Test: `./gradlew test`
- Stack: kotlin, typescript (Spring Boot, Vue, Gradle). Difficulty for a non-developer with an AI: **advanced**. A Kotlin Spring Boot server with two web front ends. Libraries, users and metadata need no code; code changes mean Kotlin, Gradle and Vue.
- The project's own AI instructions, in the repository: `AGENTS.md`.
Personal data: **yes**. Stored in: A SQLite database in /config; your files remain in your folders. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/komga/023ec90/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/komga/023ec90/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/komga/023ec90/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/komga/023ec90/r3/SKILL.md)