Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:kresus:start [2026/03/08 18:39] – créée lonclegr
+++ fr:kresus:start [2026/03/08 22:01] (Version actuelle) – lonclegr
@@ Ligne 2: / Ligne 2: @@
-Tutoriel pour utiliser Kresus avec docker compose
+===== Kesako ? =====
+> Kresus est un gestionnaire de finances personnelles gratuit et libre qui tourne sur votre serveur.
+Voilà en quelques mots de quoi il s'agit, pour plus d'informations, visitez le site officiel: https://kresus.org/
+On y trouve plein de fonctionnalités et des tutoriels.
+Alors pourquoi ajouter ce tutoriel s'il en existe déjà d'autres ? Et bien, car:
+  - mon cas d'utilisation n'est pas celui prévu à la base (je ne récupère aucune donnée automatiquement de ma banque et le compte que j'administre dans l'outil est un compte commun avec potentiellement 4 à 8 accès différents).
+  - je propose quelques astuces et retours d'expérience pour remercier les contributeurs de ce projet et lui souhaiter longue vie.
+===== Tester localement avec le minimum =====
+Pour tester localement l'application avec le minimum syndical (application et base données), je me suis servi de ce petit script et docker compose sous mon laptop en Debian 12.
+<code>
+# création du répertoire de travail
+mkdir -p ~/workspace/sandbox/kresus
+# on y va
+cd ~/workspace/sandbox/kresus
+# création du fichier compose.yaml
+cat << EOF > compose.yaml
+services:
+  db:
+    image: "postgres:16.11"
+    restart: unless-stopped
+    env_file:
+      - path: ./.env
+        required: true
+    volumes:
+      - postgres_data:/var/lib/postgresql/data/
+  kresus:
+    image: "bnjbvr/kresus:0.23.5"
+    restart: unless-stopped
+    ports:
+      - 9876:9876
+    depends_on:
+      - db
+    env_file:
+      - path: ./.env
+        required: true
+volumes:
+  postgres_data:
+EOF
+</code>
+Alors quelques commentaires sur mes choix (différences avec le [[https://framagit.org/kresusapp/kresus/-/blob/main/support/docker-compose/docker-compose.yml?ref_type=heads|compose officiel de la documentation]]):
+  - Je n'ai pas repris l'utilisation d'apprise pour les notifications. Je n'en ai pas besoin.
+  - J'ai supprimé la partie proxy via traefik car je possède déjà une stack équivalente
+  - Je n'ai un volume persistent que pour la base de données et pas pour kresus car je n'importe rien via woob.
+  - Je passe toutes les variables d'environmment via un fichier d'env obligatoire comme ci-dessous.
+<code>
+cat << EOF > .env
+POSTGRES_USER=kresus
+POSTGRES_PASSWORD=OeSoh9Dob6phahWa
+POSTGRES_DB=kresus
+LOCAL_USER_ID=1000
+KRESUS_DB_TYPE=postgres
+KRESUS_DB_HOST=db
+KRESUS_DB_PORT=5432
+KRESUS_DB_USERNAME=kresus
+KRESUS_DB_PASSWORD=OeSoh9Dob6phahWa
+KRESUS_APPRISE_API_BASE_URL=http://apprise:8000
+KRESUS_EMAIL_TRANSPORT=smtp
+KRESUS_EMAIL_FROM=kresus@domain.com
+KRESUS_EMAIL_HOST=localhost
+KRESUS_EMAIL_PORT=25
+KRESUS_EMAIL_USER=kresus
+KRESUS_EMAIL_PASSWORD=kresus
+EOF
+</code>
+Ensuite on peut lancer la stack et tester l'application localement
+<code>
+sudo docker compose up -d
+firefox http://localhost:9876
+</code>
+===== Mon retour d'expérience =====
+  - Ça fait le boulot et ça me permet d'héberger mes données où je le souhaite et du coup :-) :-)
+  - Ça a l'air d'être bien ergonomique sur téléphones intelligents et c'est très apprécié.
+  - Mes principales attentes fonctionnelles étaient de pouvoir:
+    - catégoriser les entrées/sorties d'argent
+    - visualiser le solde du compte dans le temps
+    - rechercher des dépenses comme je le souhaite avec des différents critères de sélection (dates, libellés, catégories...)
+    - Et de ce point de vue tout est là donc c'est pourquoi j'ai mis cette application en production. 8-)
+  - Les points à améliorer que je suggère:
+    - Pouvoir créer des comptes comme on le souhaite. Par défaut l'application crée 3 comptes on ne peut que les supprimer ou les renommer. Assez bizarre 8-o
+    - Pouvoir gérer un budget par an plutôt que par mois.
+    - Faire des vues personnalisées en mode lecture seule.
+    - Dernière et non des moindres: lorsqu'on définit une opération récurrente, alors proposer de les pré-créer pour l'année en cours pour que cela impacte le solde prévisionnel.
+Merci en tout cas aux développeurs pour la belle initiative.