admin
21e8df1e3a
Adds the referential-coupling backup: block to every app that binds
${HDD_PATH}/${USERDATA_PATH} (immich, paperless-ngx, nextcloud, calibre-web,
audiobookshelf, komga, navidrome, radarr, sonarr, emby, jellyfin, plex, romm).
Each lists its userdata:/hdd: binds with class mandatory|optional|excluded
(operator-ruled + spike SQ2).
Requires controller v0.132.0 (deployed) which parses+validates these blocks.
INERT — no backup tier changes behavior yet (Task 3/4 consume it). All 13
verified against the shipped parser: parse-clean, every bind resolves explicit.
audiobookshelf media/audiobooks = optional (PENDING Viktor veto to excluded).
Ref: felhom.eu/documentation/audits/SPIKE-backup-classification-2026-07-14.md
100 lines
3.5 KiB
YAML
100 lines
3.5 KiB
YAML
# =============================================================================
|
|
# .felhom.yml — App metadata for felhom-controller
|
|
# =============================================================================
|
|
# Place alongside docker-compose.yml in each stack directory:
|
|
# /opt/docker/stacks/immich/.felhom.yml
|
|
# =============================================================================
|
|
|
|
# --- Display info (shown on dashboard) ---
|
|
display_name: "Immich"
|
|
description: "Fotók és videók kezelése (Google Photos alternatíva)"
|
|
category: "media"
|
|
subdomain: "photos"
|
|
|
|
# --- Asset slug ---
|
|
slug: "immich"
|
|
|
|
# --- Resource hints (displayed on deploy screen) ---
|
|
resources:
|
|
mem_request: "2048M"
|
|
mem_limit: "4096M"
|
|
pi_compatible: false
|
|
needs_hdd: true
|
|
|
|
# --- Backup classification (referential coupling; see felhom.eu documentation/audits/SPIKE-backup-classification-2026-07-14.md) ---
|
|
backup:
|
|
hdd:
|
|
- path: appdata/immich
|
|
class: mandatory # managed upload library — DB-referenced (SQ3: restore-without = broken)
|
|
userdata:
|
|
- path: media/photos
|
|
class: optional # external library, :ro — precious but re-scanned (explicit overrides ro-default)
|
|
|
|
# --- Deploy fields ---
|
|
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: "photos"
|
|
required: true
|
|
locked_after_deploy: true
|
|
description: "Az alkalmazás aldomainje"
|
|
|
|
- env_var: DB_PASSWORD
|
|
label: "Adatbázis jelszó"
|
|
type: secret
|
|
generate: "password:24"
|
|
locked_after_deploy: true
|
|
|
|
- env_var: HDD_PATH
|
|
label: "Adattárolási útvonal"
|
|
type: path
|
|
required: true
|
|
placeholder: "/mnt/felhom-drives/hdd_1"
|
|
description: "A külső merevlemez elérési útja, ahol a fotók és videók tárolódnak"
|
|
locked_after_deploy: true
|
|
|
|
# --- App info (info page content) ---
|
|
app_info:
|
|
tagline: 'Google Photos alternatíva - automatikus fotó mentés és rendszerezés'
|
|
docs_url: 'https://immich.app/docs/overview/introduction'
|
|
|
|
use_cases:
|
|
- 'Fotók és videók automatikus mentése telefonról'
|
|
- 'Arc- és tárgyfelismerés gépi tanulással'
|
|
- 'Térképes megjelenítés helyszín alapján'
|
|
- 'Emlékek és visszatekintések automatikus generálása'
|
|
- 'Albumok létrehozása és megosztása családtagokkal'
|
|
|
|
first_steps:
|
|
- 'Nyisd meg a photos.DOMAIN címet a böngészőben'
|
|
- 'Hozd létre az admin fiókot'
|
|
- 'Telepítsd az Immich alkalmazást a telefonodra (Android/iOS)'
|
|
- 'Állítsd be az automatikus feltöltést az alkalmazásban'
|
|
- 'Hívd meg a családtagokat külön fiókokkal'
|
|
# MOUNT-READY, REGISTRATION PENDING: a megosztott média/photos mappa be van csatolva
|
|
# /external/photos néven (csak olvasható), de az Immich CSAK akkor látja, ha az
|
|
# adminfelületen (Administration → External Libraries) regisztrálod a /external/photos
|
|
# útvonalat. Compose ezt NEM teszi meg automatikusan — ez egy telepítés utáni lépés.
|
|
- 'Külső könyvtár (opcionális): Administration → External Libraries → add /external/photos'
|
|
|
|
prerequisites:
|
|
- 'Külső HDD szükséges a fotók és videók tárolásához'
|
|
- 'Legalább 4 GB szabad RAM ajánlott (gépi tanulás funkciókhoz)'
|
|
- 'x86 processzor szükséges (nem fut Raspberry Pi-n)'
|
|
|
|
# --- Controller-side health probe ---
|
|
healthcheck:
|
|
checks:
|
|
- type: api
|
|
port: 2283
|
|
path: "/api/server/ping"
|
|
expect:
|
|
status: 200
|