Files
app-catalog-felhom.eu/templates/komga/.felhom.yml
T
admin fc1becc63d
gates / gates (push) Successful in 1s
komga: 1.25.0 -> 1.27.1 and 768M (proven on the bench AND on 9202, with its test record)
Bench at 512M: proven but memory_tight (its own memory 94.6 %); per the
bar the limit is raised in the same commit and the watch re-run once:
at 768M 60 %, 0 kills, 11 940 requests all 200; abort starts-and-serves.
Box (9202, guarded Update, at 512M): done, read back, R-626 clean.
The komga fixture was fixed tonight (users/me lives at /api/v2).
09 decision 21.

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

125 lines
5.1 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
# --- 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'
# update_ladder — the test record: one tested step per line, oldest first (JSON flow mappings,
# `09-update-architecture.md` §6.4 part 4). WRITTEN BY scripts/upgrade-test.py, never by hand;
# gated by scripts/check-test-record.py. An image: move without a proven entry here is refused.
update_ladder:
- {"from": {"komga": "gotson/komga:1.25.0"}, "to": {"komga": "gotson/komga:1.27.1"}, "digest": {"komga": "sha256:9cf102f5fb78e2e020700c53eca757e4f4d4e347121b0a16380822760337cca9"}, "verdict": "proven", "tested_at": "2026-09-23T19:46:46Z", "harness_version": 3, "evidence": "felhom.eu/documentation/audits/night-2026-09-23/apps/komga/bench/evidence/MV-komga/verdict.json", "box_evidence": "felhom.eu/documentation/audits/night-2026-09-23/apps/komga/verdict.json", "memory_peak_pct": 60.0, "marks": {"files_may_change": false, "needs_person": null, "memory_tight": false}, "memory_basis": "anon", "memory_cgroup_peak_pct": 76.8}