admin
4252121519
paperless-ngx and calibre-web are the only two catalog apps with a drop-zone,
and each has exactly ONE ingest bind. Both move from ${USERDATA_PATH}/import/<app>
to ${IMPORT_PATH}/<app> — the canonical root on the system drive — so a
multi-drive box has one drop-zone instead of one real folder plus a dead
lookalike on every other drive (and import/* is class: excluded, so files
stranded in a dead one would never be backed up either).
The matching backup: entries move to the new `import:` list IN THE SAME COMMIT.
This is not cosmetic: ValidateBackupSpec rejects an entry matching no compose
bind, and the rejection is WHOLE-BLOCK, so a stale `userdata: import/paperless`
would have discarded paperless's `hdd: appdata/paperless/media class: mandatory`
too and silently degraded the customer's document originals to legacy handling.
Both classes stay `excluded` — the move must not change data handling.
New data_paths: blocks on paperless-ngx, calibre-web and romm — role + Hungarian
label over paths that already exist as compose binds. Covers all three roles and
the multi-entry case. Requires controller v0.172.0 (deployed to both demo boxes
before this push, since ${IMPORT_PATH} is unset on older controllers).
Storage-layout header comments updated in both composes — they are the only
in-repo documentation of the layout.
92 lines
3.0 KiB
YAML
92 lines
3.0 KiB
YAML
# =============================================================================
|
|
# .felhom.yml - App metadata for felhom-controller
|
|
# =============================================================================
|
|
|
|
# --- Display info (shown on dashboard) ---
|
|
display_name: "Calibre-Web Automated"
|
|
description: "Automatizált e-könyv könyvtár - konvertálás, metaadat kezelés és webes olvasó"
|
|
category: "media"
|
|
subdomain: "books"
|
|
slug: "calibre-web"
|
|
|
|
# --- Resource hints (displayed on deploy screen) ---
|
|
resources:
|
|
mem_request: "200M"
|
|
mem_limit: "768M"
|
|
pi_compatible: false
|
|
needs_hdd: true
|
|
|
|
# --- Backup classification (referential coupling; see felhom.eu documentation/audits/SPIKE-backup-classification-2026-07-14.md) ---
|
|
backup:
|
|
userdata:
|
|
- path: media/books
|
|
class: mandatory # metadata.db lives INSIDE the tree — DB and books are one unit
|
|
import:
|
|
- path: calibre
|
|
class: excluded # ingest inbox, transient
|
|
|
|
# --- Customer-facing folder annotation (R-75) ---
|
|
data_paths:
|
|
- path: calibre
|
|
root: import
|
|
role: import
|
|
label: "Beolvasandó e-könyvek"
|
|
- path: media/books
|
|
root: userdata
|
|
role: library
|
|
label: "E-könyvtár"
|
|
|
|
# --- 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: "books"
|
|
required: true
|
|
locked_after_deploy: true
|
|
description: "Az alkalmazás aldomainje"
|
|
|
|
- env_var: HDD_PATH
|
|
label: "E-könyvtár útvonal"
|
|
type: path
|
|
required: true
|
|
placeholder: "/mnt/felhom-drives/hdd_1"
|
|
description: "A külső merevlemez elérési útja, ahol a Calibre könyvtár található"
|
|
locked_after_deploy: true
|
|
|
|
# --- App info (info page content) ---
|
|
app_info:
|
|
tagline: 'Automatizált e-könyv könyvtár - könyvfeldolgozás, formátumkonverzió és OPDS feed'
|
|
default_creds: "admin / admin123"
|
|
docs_url: "https://github.com/crocodilestick/Calibre-Web-Automated/wiki"
|
|
|
|
use_cases:
|
|
- 'Automatizált e-könyv feldolgozás - csak dobd be az ingest mappába'
|
|
- 'Automatikus formátumkonverzió (EPUB, MOBI, PDF, AZW3)'
|
|
- 'OPDS feed e-olvasókhoz (Kindle, KOReader, Moon+ Reader)'
|
|
- 'Webes olvasó böngészőben'
|
|
- 'KOReader szinkronizáció (olvasási pozíció, könyvjelzők)'
|
|
|
|
first_steps:
|
|
- 'Nyisd meg a books.DOMAIN címet a böngészőben'
|
|
- 'Jelentkezz be: admin / admin123'
|
|
- 'Változtasd meg azonnal a jelszót'
|
|
- 'Dobj egy könyvet a Fájlkezelőben (FileBrowser) az import/calibre mappába — automatikusan feldolgozza és a media/books könyvtárba helyezi'
|
|
|
|
prerequisites:
|
|
- 'Külső HDD szükséges az e-könyvek tárolásához'
|
|
- 'x86 processzor szükséges (a CWA tartalmazza a Calibre binárist)'
|
|
- 'Legalább 768 MB szabad RAM ajánlott'
|
|
|
|
# --- Controller-side health probe ---
|
|
healthcheck:
|
|
checks:
|
|
- type: http
|
|
port: 8083
|