Firefly III ¶

Firefly III ist eine selbst gehostete Finanzverwaltung (Budgets, Konten, Transaktionen, Berichte) mit Weboberfläche, PostgreSQL/MySQL-Backend und optionalem Datenimport-Tool.

Voraussetzungen ¶

Keine.

Verzeichnisse anlegen ¶

Proxmox-VM ¶

mkdir /syno/firefly
mkdir /syno/firefly/upload
mkdir /syno/firefly/config
mkdir /syno/firefly/db
mkdir /syno/firefly/importer

Synology ¶

Im Docker-Ordner folgende Verzeichnisstruktur anlegen:

firefly
firefly/upload
firefly/config
firefly/db
firefly/importer

Compose-Stack ¶

version: '3.8'

services:
  app:
    image: fireflyiii/core:latest
    hostname: firefly-app
    container_name: firefly_iii_app
    restart: always
    ports:
      - 2222:8080
    volumes:
      # Für die Proxmox-VM verwenden
      - /syno/firefly/upload:/var/www/html/storage/upload
      - /syno/firefly/config:/var/www/html/storage/app/config
      - /syno/firefly/db:/var/lib/mysql

      # Für die Synology verwenden
      # Volume-Nummer ggf. anpassen
      - /volume2/docker/firefly/upload:/var/www/html/storage/upload
      - /volume2/docker/firefly/config:/var/www/html/storage/app/config
      - /volume2/docker/firefly/db:/var/lib/mysql
    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/api/v1/about"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 60s
    environment:
      - APP_KEY=<app-key>
      - APP_URL=http://192.168.111.35:2222
      - DB_HOST=db
      - DB_PORT=3306
      - DB_CONNECTION=mysql
      - DB_DATABASE=<db-name>
      - DB_USERNAME=<db-user>
      - DB_PASSWORD=<db-passwort>
      - TZ=Europe/Berlin
      - STATIC_CRON_TOKEN=<static-cron-token>
    networks:
      - firefly_net
    depends_on:
      - db

  db:
    image: mariadb:lts
    hostname: firefly-db
    container_name: firefly_iii_db
    restart: always
    environment:
      - MYSQL_DATABASE=<db-name>
      - MYSQL_USER=<db-user>
      - MYSQL_PASSWORD=<db-passwort>
      - MYSQL_RANDOM_ROOT_PASSWORD=yes
    volumes:
      # Für die Proxmox-VM verwenden
      - /syno/firefly/db:/var/lib/mysql

      # Für die Synology verwenden
      # Volume-Nummer ggf. anpassen
      - /volume2/docker/firefly/db:/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - firefly_net

  cron:
    image: alpine:latest
    restart: always
    container_name: firefly_iii_cron
    command: >
      sh -c "
        apk add --no-cache tzdata curl crond &&
        cp /usr/share/zoneinfo/Europe/Berlin /etc/localtime &&
        echo 'Europe/Berlin' > /etc/timezone &&
        echo '0 3 * * * curl -X POST http://app:8080/api/v1/cron/$${STATIC_CRON_TOKEN}' |
        crontab - &&
        crond -f -L /dev/stdout"
    environment:
      - STATIC_CRON_TOKEN=<static-cron-token>
    networks:
      - firefly_net
    depends_on:
      - app

  data-importer:
    image: fireflyiii/data-importer:latest
    container_name: firefly_iii_importer
    ports:
      - 2221:8080
    volumes:
      # Für die Proxmox-VM verwenden
      - /syno/firefly/importer:/data

      # Für die Synology verwenden
      # Volume-Nummer ggf. anpassen
      - /volume2/docker/firefly/importer:/data
    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s
    environment:
      - FIREFLY_III_URL=http://192.168.X.Y:2222
      - FIREFLY_III_ACCESS_TOKEN=<firefly-access-token>
    restart: always

networks:
  firefly_net:
    driver: bridge

Web-Zugriff ¶

• Port 2222 → 8080 (intern): Firefly III Weboberfläche
• Port 2221 → 8080 (intern): Data-Importer Weboberfläche
• Direktzugriff Firefly III: http://<host-ip>:2222
• Direktzugriff Data-Importer: http://<host-ip>:2221
• APP_URL (Firefly III) bzw. FIREFLY_III_URL (Data-Importer) müssen auf die tatsächlich genutzte Zugriffs-URL zeigen

Volumes ¶

Umgebung ¶

app ¶

db ¶

cron ¶

data-importer ¶

Netzwerk: eigenes Bridge-Netzwerk firefly_net (app, db, cron)
Neustart-Verhalten: always (alle Services)