Aller au contenu

Firefly III

Application de gestion des comptes bancaires

Installation

Le docker est un peu complexe mais il fonctionne bien. Au total, il y aura 4 docker différents qui se lanceront.

docker-compose.yml
services:
  app:
    image: fireflyiii/core:latest
    hostname: app
    container_name: firefly_iii_core
    restart: always
    volumes:

      - ./firefly_iii_upload:/var/www/html/storage/upload
    env_file: .env
    networks:

      - firefly_iii
    ports:

      - 8080:8080
    depends_on:

      - db

  db:
    image: mariadb:lts
    hostname: db
    container_name: firefly_iii_db
    restart: always
    env_file: .db.env
    networks:

      - firefly_iii
    volumes:

      - ./firefly_iii_db:/var/lib/mysql

  importer:
    image: fireflyiii/data-importer:latest
    hostname: importer
    restart: always
    container_name: firefly_iii_importer
    networks:

      - firefly_iii
    ports:

      - '8082:8080'
    depends_on:

      - app
    env_file: .importer.env

  cron:
    #
    # To make this work, set STATIC_CRON_TOKEN in your .env file or as an environment variable and replace REPLACEME below
    # The STATIC_CRON_TOKEN must be *exactly* 32 characters long
    #
    image: alpine
    restart: always
    container_name: firefly_iii_cron
    env_file: .env
    command: sh -c "
      apk add tzdata
      && ln -s /usr/share/zoneinfo/${TZ} /etc/localtime
      | echo \"0 3 * * * wget -qO- http://app:8080/api/v1/cron/<KEY>;echo\"
      | crontab -
      && crond -f -L /dev/stdout"
    networks:

      - firefly_iii

volumes:
   firefly_iii_upload:
   firefly_iii_db:

networks:
  firefly_iii:
    driver: bridge

Si l'application doit être utilisable depuis internet en passant par un reverse proxy pour gérer la redirection de port, il faut absolument activer cette option dans le .env et le .importer.env: TRUSTED_PROXIES=*

Configuration de l'importer

L'importer est un docker à part entière. Il a sa propre interface avec un numéro de port différent.

Chez moi, c'est sur le port 8082. Il faut ouvrir l'interface et suivre les instructions :

  • Déclarer un nouveau client dans firefly (via Préférences > Profil > OAuth)
  • Donner un nom, copier l'url de callback fournie par l'importer
  • Décocher Confidentiel
  • Récupérer le client id
  • Reporter le client id et l'url de firefly dans la page d'accueil de l'importer
  • Autoriser l'importer à accéder à l'application

L'importer est maintenant configurer. Il sera possible de balancer des fichier CSV (peut-être QIF mais je crois pas). Il faudra alors configurer la correspondance des colonnes étant donné que le format csv n'est pas standardisé et dépend de chaque banque.

Il est possible de créer une connexion automatique avec un compte en banque personnel. Malheureusement, les API ne sont pas publiques et on doit passer par un service tier comme GoCardless ou Spectre.

🏦 GoCardless

L'inscription au service GoCardless est une galère pas possible. C'est normalement un service réservé aux professionnels (car proposant la mise en place de paiements clients) et lors de l'inscription, on demande un numéro SIRET.

En passant par le support, je suis parvenu à créer un compte conforme à mon besoin mais je ne sais plus comment j'ai fait.

Au final, j'ai une interface sur https://bankaccountdata.gocardless.com/overview/. Je peux créer un SECRET_ID et un SECRET_KEY normalement utilisable par l'importer mais je n'ai pas réussi à le faire fonctionner avec Boursorama... Je pense que ça vient de boursorama puisqu'avec Société Générale, ça marche nickel.

Sources