app-catalog-felhom.eu/templates/immich/.felhom.yml

# =============================================================================
# .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"
# 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-22"

# --- 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:
  # container: no exact match and FOUR `immich-*` containers, so the old prefix rule picked whichever the
  # container list happened to yield first — it could have been `immich-postgres` (R-630)
  container: immich-server
  checks:
    - type: api
      port: 2283
      path: "/api/server/ping"
      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: 'Photos and videos in one place (a Google Photos alternative)'
    app_info:
      tagline: 'A Google Photos alternative - your photos back themselves up and sort themselves'
      use_cases:
        - 'Photos and videos back themselves up from your phone'
        - 'It recognises faces and objects on its own'
        - 'See where a photo was taken, on a map'
        - 'Memories and look-backs, put together for you'
        - 'Build albums and share them with the household'
      first_steps:
        - 'Open photos.DOMAIN in your browser'
        - 'Create the admin account'
        - 'Install the Immich app on your phone (Android/iOS)'
        - 'Turn on automatic upload in the app'
        - 'Invite the household, each with their own account'
        - 'An external library (optional): Administration -> External Libraries -> add /external/photos'
      prerequisites:
        - 'An external hard drive is needed to keep the photos and videos on'
        - 'At least 4 GB of free RAM is recommended (for the machine learning features)'
        - 'An x86 processor is needed (it does not run on a Raspberry Pi)'
    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: DB_PASSWORD
        label: 'Database password'
      - env_var: HDD_PATH
        label: 'Data storage path'
        description: 'The path to the external hard drive where the photos and videos are kept'
        placeholder: '/mnt/felhom-drives/hdd_1'