Files
app-catalog-felhom.eu/templates/komga/steps/f7c491acf8f39ff8.felhom.yml
T
admin 403a8f537a
gates / gates (push) Successful in 2s
komga: within-major step, both venues proven (R-462, Part F)
{'komga': 'gotson/komga:1.27.1'} -> {'komga': 'gotson/komga:1.28.0'}
The ONLY image move in this commit. Written by upgrade-test.py --write-ladder (catalog gates rc=0):
- bench LXC 9401 (harness v4): the seed read back before and after; 10-minute memory watch:
  komga anon 64.5 % (cgroup 67.5 %); 0 kills, 0 restarts; the abort starts and serves the data;
- box 9202 (controller 0.283.1, the product's guarded Update, drill catalog): done in 44.2 s, the seed
  read back through the app's own front door.
Evidence: felhom.eu/documentation/audits/pg-last-six-2026-09-30/F/ and .../box/komga/

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0159rPz1ZhFKsS53msqPYxtS
2026-09-30 14:30:27 +02:00

128 lines
4.6 KiB
YAML

# =============================================================================
# .felhom.yml - App metadata for felhom-controller
# =============================================================================
# --- Display info (shown on dashboard) ---
display_name: "Komga"
description: "Képregény és manga szerver OPDS támogatással"
category: "media"
subdomain: "comics"
slug: "komga"
# catalog_since: the date THIS repo last changed this app's pinned images. Any commit that
# changes an image: line must set this to the same day (see CLAUDE.md).
catalog_since: "2026-09-23"
# --- Resource hints (displayed on deploy screen) ---
resources:
mem_request: "200M"
mem_limit: "768M"
pi_compatible: true
needs_hdd: true
# --- Backup classification (referential coupling; see felhom.eu documentation/audits/SPIKE-backup-classification-2026-07-14.md) ---
backup:
userdata:
- path: media/comics
class: optional # ruled: precious-decoupled (re-scanned, hand-curated)
# --- Deploy fields (first deployment only) ---
deploy_fields:
- env_var: DOMAIN
label: "Domain"
type: domain
description: "A szerver domain neve"
locked_after_deploy: true
- env_var: SUBDOMAIN
label: "Aldomain"
type: subdomain
default: "comics"
required: true
locked_after_deploy: true
description: "Az alkalmazás aldomainje"
- env_var: HDD_PATH
label: "Képregénytár útvonal"
type: path
required: true
placeholder: "/mnt/felhom-drives/hdd_1"
description: "A külső merevlemez elérési útja"
locked_after_deploy: true
# --- The setup gate (controller >= 0.281.0, `09` §3 decisions 46-47) ---
# The first visitor would create the admin; a fresh install is closed to everyone but the household until the first setup is done.
setup_gate: true
# measured on 9202 2026-09-29: isClaimed false -> true once the admin claimed it.
setup_done_probe:
url: http://komga:25600/api/v1/claim
field: isClaimed
done: "true"
# --- App info (info page content) ---
app_info:
tagline: "Képregény, manga és könyv szerver webes olvasóval"
docs_url: "https://komga.org/docs/"
use_cases:
- 'Képregények és mangák rendszerezése és olvasása böngészőben'
- 'Automatikus metaadat szkennelés és borítókép generálás'
- 'OPDS feed kompatibilis olvasó alkalmazásokhoz'
- 'Olvasási haladás szinkronizálás eszközök között'
- 'Több felhasználó külön könyvtárral'
first_steps:
- 'Nyisd meg a comics.DOMAIN címet a böngészőben'
- 'Hozd létre az admin fiókot az első megnyitáskor'
- 'Add hozzá a könyvtárat (/data)'
- 'Várd meg az automatikus szkennelést'
- 'Használj OPDS-kompatibilis alkalmazást mobilon (pl. Tachiyomi)'
prerequisites:
- 'Külső HDD szükséges a képregények tárolásához'
- 'Támogatott formátumok: CBZ, CBR, PDF, EPUB'
# --- Controller-side health probe ---
healthcheck:
checks:
- type: api
port: 25600
# /actuator/health is unauthenticated (200); the /api/v1 prefix is auth-gated (401).
path: "/actuator/health"
expect:
status: 200
# --- English copy (localisation slice 5, R-560) --------------------------------------------
# The Hungarian above is UNCHANGED. A box on English reads this block field by field; a missing
# field shows the Hungarian one; a controller older than 0.257.0 ignores the block entirely.
i18n:
en:
description: 'A comic and manga server with OPDS support'
app_info:
tagline: 'A comic, manga and book server with a web reader'
use_cases:
- 'Sort and read comics and manga in your browser'
- 'Details are scanned in and covers made on their own'
- 'An OPDS feed for reader apps'
- 'Your reading position follows you between devices'
- 'Several people, each with their own library'
first_steps:
- 'Open comics.DOMAIN in your browser'
- 'Create the admin account the first time you open it'
- 'Add the library (/data)'
- 'Wait for the first scan to finish'
- 'Use an OPDS-compatible app on your phone (Tachiyomi, for example)'
prerequisites:
- 'An external hard drive is needed to keep the comics on'
- 'Formats it reads: CBZ, CBR, PDF, EPUB'
deploy_fields:
- env_var: DOMAIN
label: 'Domain'
description: 'The server domain name'
- env_var: SUBDOMAIN
label: 'Subdomain'
description: 'The subdomain this app answers on'
- env_var: HDD_PATH
label: 'Comic library path'
description: 'The path to the external hard drive'
placeholder: '/mnt/felhom-drives/hdd_1'