Comment installer Firefly III sur Saplo (budget et finances sans application bancaire)

Si tu as des comptes dans deux ou trois banques, tu connais ce problème : pour avoir une vue d'ensemble de tes finances, tu dois te connecter à plusieurs applications bancaires l'une après l'autre et additionner les chiffres dans ta tête ou dans une feuille de calcul séparée. Une feuille de calcul ne résout le problème qu'à moitié, car chaque transaction doit être saisie manuellement, et après quelques mois, les catégories ne correspondent plus, les formules se cassent et le budget domestique n'est plus à jour. Firefly III est une application open source pour le budget et les finances personnelles ou professionnelles, les comptes, les catégories, les budgets, les tags et les rapports en un seul endroit, avec la possibilité d'importer des relevés CSV via l'application complémentaire Data Importer, que tu installes sur ta propre Box plutôt que dans une application bancaire tierce ou une feuille de calcul désorganisée. Voici comment installer Firefly III sur Saplo, étape par étape.

Pourquoi Firefly III plutôt qu'une application bancaire et une feuille de calcul

L'application bancaire et la feuille de calcul sont gratuites, mais elles présentent des inconvénients qui n'apparaissent qu'après une utilisation prolongée, pas immédiatement au démarrage :

• L'application bancaire n'affiche qu'une seule banque, donc si tu as des comptes dans plusieurs établissements, il n'y a pas un seul endroit avec une vue complète de tes dépenses, de tes économies et de ton budget.
• La feuille de calcul exige la saisie manuelle de chaque transaction, et plus elle est tenue longtemps, plus il est facile de faire une erreur de formule ou d'oublier une catégorie.
• Les données financières dans l'application bancaire sont sous le contrôle de la banque, et non de la personne qui les saisit, et l'historique du budget des années précédentes ne peut généralement pas être exporté sous une forme utilisable.

Firefly III n'a aucune de ces limitations, car il fonctionne comme un ensemble de conteneurs Docker sur ta propre Box : il agrège un nombre illimité de comptes, compile des budgets et des catégories basés sur les transactions saisies, et les données restent sur ton serveur, pas dans le cloud de quelqu'un d'autre.

Exigences

Pour installer Firefly III sur Saplo, tu as besoin de :

• Une Box avec Docker activé (le moteur l'active automatiquement lors de l'installation depuis le catalogue, le nesting dans le conteneur est requis, ce que Saplo propose par défaut),
• Un minimum de 512 Mo de RAM disponible sur la Box et de 2 Go d'espace disque, ce qui est inclus dans le plan Box S à 27 € par an,
• Un domaine ou sous-domaine *.saploapp.pl, inclus dans chaque plan, sur lequel sera hébergé le panneau Firefly III,
• Tu n'as PAS besoin de créer une base de données séparée manuellement, Firefly III reçoit sa propre base de données vide dans le MySQL partagé de Saplo, le moteur transmet automatiquement les données d'accès.

La description complète de l'application et son emplacement dans le catalogue sont disponibles sur la page Firefly III sur Saplo.

Installation étape par étape

1. Dans ton panneau Saplo, va dans Catalogue d'applications et choisis Firefly III.
2. Indique une Box avec un minimum de 512 Mo de RAM libre sur laquelle l'application doit être installée, ainsi que le domaine ou le sous-domaine sous lequel le panneau fonctionnera.
3. Confirme l'installation. Le moteur installe deux conteneurs : l'application à partir de l'image officielle fireflyiii/core, exposée uniquement sur le loopback de la Box et connectée à nginx avec SSL gratuit, et un conteneur cron léger séparé (alpine), qui déclenche une fois par nuit la tâche responsable des transactions récurrentes et des règles automatiques, conformément à la documentation officielle de Firefly III.
4. Après le démarrage des conteneurs, le moteur vérifie si l'application fonctionne réellement. La migration du schéma de la base de données lors du premier démarrage peut prendre un peu plus de quelques secondes standard.
5. Une fois l'installation terminée, le panneau Firefly III est disponible sous le domaine indiqué.

Première configuration

Firefly III ne crée pas automatiquement un compte administrateur, car il n'y a pas d'API intégrée pour cela au démarrage du conteneur.

1. Rends-toi à l'adresse du domaine et clique sur inscription. La première personne qui crée un compte obtient automatiquement les droits de propriétaire.
2. Dans la section Accounts, ajoute des comptes d'actifs (asset accounts), un pour chaque compte bancaire ou liquidité que tu souhaites suivre.
3. Dans les sections Categories et Budgets, configure tes propres catégories de dépenses et des plafonds budgétaires mensuels adaptés à tes finances.
4. Tu ajoutes les transactions manuellement dans le panneau. L'importation de fichiers CSV nécessite une application distincte, Firefly III Data Importer, que cette recette n'installe pas. Le simple fait d'exécuter Firefly III ne garantit pas l'importation CSV ni le téléchargement automatique des relevés bancaires.
5. Les transactions récurrentes et les règles automatiques (par exemple, un virement de loyer fixe) se déclenchent automatiquement grâce à un conteneur cron séparé, qui déclenche l'endpoint approprié une fois par nuit. Il n'est pas nécessaire de lancer quoi que ce soit manuellement.

Firefly III sur Saplo vs application bancaire et feuille de calcul

Questions fréquentes

Est-ce que Firefly III importe automatiquement les relevés bancaires ? Non. Dans l'installation décrite, tu ajoutes les transactions manuellement. L'importation d'un fichier CSV nécessite également un Firefly III Data Importer séparé, dont la recette Saplo ne prévoit pas l'installation. Consulte les instructions officielles d'importation CSV.

Combien de comptes bancaires puis-je ajouter ? Sans limite, le nombre de comptes de patrimoine dans Firefly III n'est limité que par les ressources de la Box.

Doit-on créer soi-même la base de données ? Non, le moteur crée une base de données vide dans le MySQL partagé de Saplo et transmet automatiquement les données d'accès au conteneur lors de l'installation.

Qui obtient les droits d'administrateur ? La première personne qui s'inscrit sur le site juste après l'installation obtient automatiquement les droits de propriétaire, il est donc conseillé de créer un compte immédiatement après la fin de l'installation.

Est-ce que les transactions récurrentes et les règles automatiques fonctionnent toutes seules ? Oui, grâce à un conteneur cron séparé qui déclenche le point de terminaison approprié de l'application chaque nuit, exactement comme le recommande la documentation officielle de Firefly III.

Firefly III est l'une des plus de 160 applications que tu peux lancer sur Saplo depuis notre catalogue. Nous décrivons le fonctionnement de l'hébergement d'applications dans une seule Box sur une page séparée.

Si tu en as assez de passer d'une application bancaire à l'autre et de remplir manuellement une feuille de calcul, écris-nous, nous t'aiderons à choisir la bonne Box et à installer Firefly III.