avm/hassio-addons
1
0
Fork 0
mirror of https://github.com/alexbelgium/hassio-addons.git synced 2026-08-25 14:23:33 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
fix/komga-readiness-probe
hassio-addons/komga
History
alexbelgium 98c2fab87f fix(komga): ship an apparmor profile so local disks can be mounted 
Without apparmor.txt Supervisor adds no apparmor security_opt, so Docker's
default profile applies and denies mount() and raw block device access:
mount reported 'cannot mount /dev/sda1 read-only' and the kernel logged
'/dev/disk/by-label/NAS: Can't open blockdev'.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-12 08:31:49 +02:00
..
rootfs/etc
fix(komga): use a wall clock deadline for the readiness wait
2026-08-11 19:16:57 +02:00
apparmor.txt
fix(komga): ship an apparmor profile so local disks can be mounted
2026-08-12 08:31:49 +02:00
build.json
fix(komga): restore add-on reverted by a transient ghcr.io login failure (#2960)
2026-08-11 18:44:54 +02:00
CHANGELOG.md
fix(komga): ship an apparmor profile so local disks can be mounted
2026-08-12 08:31:49 +02:00
config.yaml
fix(komga): ship an apparmor profile so local disks can be mounted
2026-08-12 08:31:49 +02:00
Dockerfile
fix(komga): restore add-on reverted by a transient ghcr.io login failure (#2960)
2026-08-11 18:44:54 +02:00
icon.png
fix(komga): restore add-on reverted by a transient ghcr.io login failure (#2960)
2026-08-11 18:44:54 +02:00
logo.png
fix(komga): restore add-on reverted by a transient ghcr.io login failure (#2960)
2026-08-11 18:44:54 +02:00
README.md
fix(komga): restore add-on reverted by a transient ghcr.io login failure (#2960)
2026-08-11 18:44:54 +02:00
updater.json
fix(komga): restore add-on reverted by a transient ghcr.io login failure (#2960)
2026-08-11 18:44:54 +02:00

README.md

Home Assistant Add-on: Komga

Free and open source comics/mangas media server.

Komga organizes your comics, mangas, BDs, magazines and ebooks, serves them through a web reader, and exposes OPDS, Kobo sync and a REST API for third-party readers (Tachiyomi/Mihon, Panels, Chunky, ...).

About

  • Browse and read CBZ, CBR, PDF and EPUB files from any browser
  • Import metadata, edit series/books, build collections and read lists
  • Multi-user, with per-user library restrictions and age ratings
  • OPDS v1/v2, Kobo sync, and a documented REST API

Installation

  1. Add this repository to Home Assistant.
  2. Install the Komga add-on.
  3. Start the add-on and open it from the sidebar (ingress), or on port 25600 at http://homeassistant:25600/komga.
  4. Create the initial user account when the web interface asks for it.
  5. Add a library pointing at your comics, for example /media/comics or /share/comics.

The first start takes longer than usual: Komga is a JVM application and builds its database and search index on first boot.

Configuration

Option Description
PUID / PGID Ownership applied to the add-on configuration directory. Defaults to 0 (root).
TZ Timezone, e.g. Europe/Paris.
localdisks Local disks to mount, e.g. sda1 or a disk label.
networkdisks SMB shares to mount, e.g. //192.168.1.2/comics. Mounted under /mnt.
cifsusername / cifspassword / cifsdomain Credentials for the SMB shares.
smbv1 Allow the legacy SMBv1 protocol.
env_vars Extra environment variables passed to Komga. See the wiki.

Most Komga settings can be passed through env_vars using the upstream naming, see the Komga configuration options. A common one:

  • JAVA_TOOL_OPTIONS = -Xmx1g — cap the JVM heap on small machines.

SERVER_SERVLET_CONTEXTPATH and SERVER_PORT are reserved by the add-on: ingress is built around the /komga path on port 25600, and overriding either breaks the sidebar panel.

Ingress and URLs

Komga is served from the /komga subpath so that it works behind Home Assistant ingress:

  • from the Home Assistant sidebar: ingress, no extra setup
  • directly: http://homeassistant:25600/komga

External clients — OPDS readers, Kobo sync, Tachiyomi/Mihon, Panels — must use the direct http://homeassistant:25600/komga url. Ingress is browser-session based, so those clients cannot authenticate through it.

Data

Komga's database, logs and search index live in /config inside the add-on, which Home Assistant maps to this add-on's own configuration directory — /addon_configs/<repository_id>_komga, browsable with the Filebrowser add-on. They survive add-on updates. Libraries stay where you put them, under /media, /share or a mounted disk.

Support