[{"data":1,"prerenderedAt":187},["ShallowReactive",2],{"seo-verification":3,"blog-heberger-firefly-iii-vps-fr":6},{"google":4,"bing":5},"EycwPY2XMyTkVzas3n1ygeNJFGAH513qrMjfDljzsMQ","",{"id":7,"slug":8,"slugs":9,"title":12,"excerpt":13,"readTime":14,"views":15,"isPinned":16,"publishedAt":17,"category":18,"categories":24,"featuredImage":26,"bgImage":27,"posterImage":28,"relatedSolution":26,"intro":29,"sections":30,"ctaTitle":131,"ctaBody":132,"ctaButton":133,"ctaUrl":134,"relatedPosts":135},266,"heberger-firefly-iii-vps",{"fr":8,"en":10,"ar":11},"self-host-firefly-iii-on-a-vps-business-finances-under-control","استضافة-firefly-iii-على-vps-ماليتك-المهنية-تحت-السيطرة","Héberger Firefly III sur un VPS : finances pro sous contrôle","Déployez Firefly III sur votre VPS en 20 minutes avec Docker Compose. Suivi des dépenses, budgets et rapports — vos données financières, sur votre propre serveur.",11,0,false,"2026-08-15T00:00:00+00:00",{"id":19,"name":20,"slug":21,"color":22,"icon":23},7,"Self-hosting","self-hosting","bg-indigo-500\u002F10 text-indigo-400","cloud",[25],{"id":19,"name":20,"slug":21,"color":22,"icon":23},null,"\u002Fblog\u002Fcovers\u002Fbg.svg","\u002Fblog\u002Fcovers\u002Fheberger-firefly-iii-vps-poster.svg","Garder ses finances professionnelles dans un tableur Excel ou dans un outil SaaS dont vous n'êtes pas propriétaire, c'est acceptable au démarrage — mais quand les comptes se multiplient, que les clients se diversifient et que le cabinet comptable demande des exports cohérents, il faut autre chose. Firefly III est une application de gestion financière personnelle et professionnelle open source (AGPL-3.0) qui s'installe sur votre VPS en vingt minutes, ne dépend d'aucun abonnement et héberge vos données exactement là où vous le décidez.",[31,35,46,49,71,74,77,81,125,128],{"type":32,"title":33,"body":34},"h2","Pourquoi Firefly III plutôt qu'un outil SaaS ?","Les gestionnaires de finances en ligne (YNAB, Mint, Freeform…) imposent un abonnement mensuel, hébergent vos données sur leurs serveurs américains et peuvent fermer leur service sans préavis. Pour un indépendant ou une petite structure, les implications RGPD de partager ses relevés bancaires avec un tiers sont rarement évaluées.\n\nFirefly III règle ces trois problèmes à la fois : **licence AGPL-3.0** (code ouvert, modifiable), **docker-compose** en moins de dix commandes, données dans votre propre base PostgreSQL. Avec **24 300 étoiles sur GitHub** et une v6.6.6 sortie en juillet 2025, c'est un projet mature, activement maintenu et documenté.\n\nCe que Firefly III gère pour vous : comptes courants et d'épargne, cartes de crédit, portefeuilles de cryptomonnaies, budgets mensuels ou annuels, règles d'automatisation des transactions, catégories personnalisées, rapports par période ou catégorie, et import depuis vos relevés bancaires via le **Data Importer**.",{"type":36,"title":37,"items":38},"ul","Fonctionnalités clés",[39,40,41,42,43,44,45],"**Multi-comptes** : gérez simultanément plusieurs comptes courants, d'épargne, cartes de crédit et portefeuilles crypto.","**Budgets et enveloppes** : définissez des budgets mensuels par catégorie (loyer, fournitures, honoraires…) et suivez leur consommation en temps réel.","**Règles d'automatisation** : créez des règles qui s'appliquent automatiquement aux nouvelles transactions (ex. : dépenses Uber → catégorie Transports).","**Rapports avancés** : graphiques par période, par compte, par catégorie, exportables en CSV pour votre comptable.","**Data Importer** : importez vos relevés bancaires au format OFX, QFX, CSV ou via des connecteurs bancaires européens (Nordigen\u002FGoCardless).","**API REST complète** : automatisez la création de transactions depuis n'importe quel script ou outil tiers.","**Interface mobile responsive** : accédez à vos comptes depuis votre téléphone via le navigateur.",{"type":32,"title":47,"body":48},"Prérequis serveur","Firefly III est une application PHP\u002FLaravel légère. Voici ce dont vous avez besoin :\n\n- Un VPS sous Ubuntu 22.04 ou Debian 12 avec **au moins 1 Go de RAM** (2 Go recommandés).\n- **Docker Engine ≥ 24** et Docker Compose V2 installés.\n- Un **nom de domaine** pointant vers votre VPS (recommandé pour configurer TLS).\n- Un port **8080** accessible (UI Firefly III) et **8081** (Data Importer, optionnel).\n- **5 Go de stockage** minimum pour la base de données et les pièces jointes.\n\nFirefly III ne nécessite pas de GPU ni de RAM excessive — c'est l'un de ses avantages par rapport à des outils comme ERPNext.",{"type":50,"title":51,"steps":52},"steps","Installation avec Docker Compose",[53,56,59,62,65,68],{"title":54,"body":55},"Étape 1 — Cloner le dépôt officiel","Firefly III fournit un fichier `docker-compose.yml` officiel et un template `.env` dans son dépôt `firefly-iii\u002Fdocker` :\n\n```bash\nmkdir -p \u002Fopt\u002Ffirefly && cd \u002Fopt\u002Ffirefly\ncurl -L https:\u002F\u002Fraw.githubusercontent.com\u002Ffirefly-iii\u002Fdocker\u002Fmain\u002Fdocker-compose-importer.yml \\\n  -o docker-compose.yml\ncurl -L https:\u002F\u002Fraw.githubusercontent.com\u002Ffirefly-iii\u002Ffirefly-iii\u002Fmain\u002F.env.example \\\n  -o .env\ncurl -L https:\u002F\u002Fraw.githubusercontent.com\u002Ffirefly-iii\u002Fdata-importer\u002Fmain\u002F.env.example \\\n  -o .importer.env\n```",{"title":57,"body":58},"Étape 2 — Configurer les variables d'environnement","Ouvrez `.env` et modifiez ces variables :\n\n```bash\n# Base de données\nDB_HOST=db\nDB_PORT=5432\nDB_DATABASE=firefly\nDB_USERNAME=firefly\nDB_PASSWORD=MOT_DE_PASSE_FORT_ICI\n\n# Clé d'application — OBLIGATOIRE, 32 caractères exactement\nAPP_KEY=SomeLongRandomStringOf32CharsMin\n\n# URL de votre instance\nAPP_URL=https:\u002F\u002Ffirefly.votredomaine.com\n\n# Mot de passe administrateur PostgreSQL\nPOSTGRES_PASSWORD=MOT_DE_PASSE_POSTGRES\n```\n\n⚠️ La variable `APP_KEY` doit contenir **exactement 32 caractères** alphanumériques. Générez-en une avec `openssl rand -hex 16`.",{"title":60,"body":61},"Étape 3 — Lancer les conteneurs","```bash\ndocker compose up -d\n```\n\nLe démarrage complet prend 30 à 60 secondes. Vérifiez l'état des conteneurs :\n\n```bash\ndocker compose ps\n```\n\nVous devez voir trois conteneurs en état `healthy` (ou `running`) : `firefly-iii`, `db` (PostgreSQL) et `importer`. Firefly III attend que PostgreSQL soit prêt grâce à la directive `depends_on: condition: service_healthy` dans le `docker-compose.yml` — vous n'avez rien à gérer manuellement.",{"title":63,"body":64},"Étape 4 — Accéder à l'interface","Ouvrez votre navigateur sur `http:\u002F\u002F\u003CIP_VPS>:8080`. Firefly III vous invite à créer votre compte administrateur. Renseignez votre adresse e-mail et un mot de passe. Une fois connecté, l'assistant de configuration vous guide pour créer votre premier compte bancaire.",{"title":66,"body":67},"Étape 5 — Configurer Nginx avec TLS","Ne laissez pas Firefly III accessible sans HTTPS en production. Configurez Nginx comme reverse proxy :\n\n```bash\napt install -y nginx certbot python3-certbot-nginx\n\ncat > \u002Fetc\u002Fnginx\u002Fsites-available\u002Ffirefly \u003C\u003C 'EOF'\nserver {\n    server_name firefly.votredomaine.com;\n    location \u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:8080;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n    }\n}\nEOF\n\nln -s \u002Fetc\u002Fnginx\u002Fsites-available\u002Ffirefly \u002Fetc\u002Fnginx\u002Fsites-enabled\u002F\ncertbot --nginx -d firefly.votredomaine.com\nnginx -t && systemctl reload nginx\n```\n\nFermez ensuite le port 8080 dans votre pare-feu (`ufw deny 8080`).",{"title":69,"body":70},"Étape 6 — Importer vos relevés bancaires","Le **Data Importer** écoute sur le port 8081. Accédez à `http:\u002F\u002F\u003CIP_VPS>:8081` pour lancer l'import.\n\n1. Cliquez sur **Import** puis **Upload a file**.\n2. Sélectionnez votre fichier OFX, QFX ou CSV exporté depuis votre banque.\n3. L'assistant vous guide pour mapper les colonnes (date, montant, description, compte).\n4. Validez l'import : les transactions apparaissent immédiatement dans Firefly III.\n\nPour automatiser les imports, configurez un connecteur **GoCardless** (anciennement Nordigen) depuis l'interface du Data Importer pour synchroniser automatiquement vos comptes bancaires européens.",{"type":32,"title":72,"body":73},"Configurer les budgets et les règles d'automatisation","**Créer un budget mensuel :**\n1. Allez dans **Budgets → New budget**.\n2. Nommez le budget (ex. « Fournitures bureau ») et définissez le montant mensuel.\n3. Associez les transactions à ce budget manuellement ou via une règle.\n\n**Créer une règle d'automatisation :**\n1. Allez dans **Automation → Rules → New rule**.\n2. Définissez le déclencheur : par exemple « La description contient 'Amazon' ».\n3. Définissez l'action : « Assigner à la catégorie Fournitures » et « Assigner au budget Fournitures bureau ».\n4. La règle s'applique automatiquement aux nouvelles transactions et peut être rejouée sur l'historique.\n\n**Exporter pour votre comptable :**\nAllez dans **Export data** et choisissez le format CSV. Filtrez par période (ex. T1 2026) et par compte. Le fichier export contient toutes les transactions avec date, montant, description, catégorie et budget.",{"type":32,"title":75,"body":76},"Planifier des sauvegardes automatiques","Firefly III stocke ses données dans PostgreSQL. Voici comment planifier une sauvegarde quotidienne :\n\n```bash\nmkdir -p \u002Fopt\u002Ffirefly\u002Fbackups\n\ncat > \u002Fopt\u002Ffirefly\u002Fbackup.sh \u003C\u003C 'EOF'\n#!\u002Fbin\u002Fbash\nDATE=$(date +%Y%m%d)\ndocker compose -f \u002Fopt\u002Ffirefly\u002Fdocker-compose.yml exec -T db \\\n  pg_dump -U firefly firefly | gzip > \u002Fopt\u002Ffirefly\u002Fbackups\u002Ffirefly-$DATE.sql.gz\nfind \u002Fopt\u002Ffirefly\u002Fbackups -name '*.sql.gz' -mtime +30 -delete\nEOF\nchmod +x \u002Fopt\u002Ffirefly\u002Fbackup.sh\n\n# Cron quotidien à 03:00\necho '0 3 * * * root \u002Fopt\u002Ffirefly\u002Fbackup.sh' >> \u002Fetc\u002Fcron.d\u002Ffirefly-backup\n```\n\nPour une protection complète, complétez avec une sauvegarde hors-site (rclone vers S3, SFTP vers un autre VPS).",{"type":78,"title":79,"body":80},"tip","APP_KEY invalide : l'erreur la plus courante","Si Firefly III affiche une erreur blanche au démarrage ou si l'authentification échoue sans message clair, vérifiez en premier la variable `APP_KEY` dans votre fichier `.env`.\n\n**Deux règles strictes :**\n1. La clé doit contenir **exactement 32 caractères**.\n2. Elle ne doit **jamais changer** après le premier démarrage — changer l'`APP_KEY` sur une instance existante invalide toutes les sessions et chiffre les données stockées de façon incompatible.\n\n**Générer une clé valide :**\n\n```bash\nopenssl rand -hex 16\n# Exemple de sortie : a8f2c9d1e4b7f0a3c5e8d2b1f4a7e0c3\n```\n\nCette commande produit exactement 32 caractères hexadécimaux — parfait pour `APP_KEY`.",{"type":82,"title":83,"headers":84,"rows":89},"comparison","Firefly III vs YNAB vs Budgea",[85,86,87,88],"Critère","Firefly III (self-hosted)","YNAB","Budgea",[90,95,100,105,109,113,117,121],[91,92,93,94],"Prix","Gratuit (coût VPS ~5-10€\u002Fmois)","~99$\u002Fan","~60€\u002Fan",[96,97,98,99],"Hébergement données","Votre VPS (souveraineté totale)","Serveurs US (Plaid)","Serveurs FR",[101,102,103,104],"Import bancaire","CSV\u002FOFX + GoCardless (EU)","Connexion directe (US)","Connexion directe (FR)",[106,107,107,108],"Règles d'automatisation","Oui","Non",[110,111,112,108],"API REST","Oui (complète)","Non publique",[114,107,115,116],"Multi-devises","Non (USD only)","Oui (partiel)",[118,119,120,120],"Rapports personnalisables","Oui (avancés)","Limités",[122,123,124,107],"Application mobile native","Non (web responsive)","Oui (iOS\u002FAndroid)",{"type":32,"title":126,"body":127},"Résoudre les problèmes fréquents","**Firefly III reste en page blanche ou affiche une erreur 500**\nVérifiez les logs du conteneur : `docker compose logs firefly-iii`. Les erreurs les plus fréquentes sont une `APP_KEY` invalide ou un PostgreSQL non encore prêt. Solution : vérifier que `db` est en état `healthy` avec `docker compose ps` avant d'accéder à l'UI.\n\n**Le Data Importer refuse le fichier CSV**\nFirefly III attend un format CSV spécifique. Si votre banque exporte un CSV avec des séparateurs point-virgule (;) au lieu de virgule, modifiez l'encodage dans l'assistant d'import ou convertissez le fichier avec `sed 's\u002F;\u002F,\u002Fg' import.csv > import-virgule.csv`.\n\n**Les transactions en double après import**\nActivez la déduplication dans le Data Importer : dans la configuration de l'import, cochez **Ignore duplicates**. Firefly III compare les transactions par date, montant et description pour éviter les doublons.\n\n**Erreur `Connection refused` à la base de données au démarrage**\nFirefly III utilise `depends_on: condition: service_healthy` pour attendre PostgreSQL. Si cette erreur persiste, vérifiez que `POSTGRES_PASSWORD` dans `.env` correspond à `DB_PASSWORD`.",{"type":32,"title":129,"body":130},"Mettre à jour Firefly III","La v6.6.6 est sortie en juillet 2025. La mise à jour se fait en deux commandes :\n\n```bash\ncd \u002Fopt\u002Ffirefly\ndocker compose pull\ndocker compose up -d\n```\n\nDocker Compose télécharge les nouvelles images, arrête les anciens conteneurs et redémarre avec la version mise à jour. Les migrations de base de données s'exécutent automatiquement au premier démarrage de la nouvelle version. **Avant chaque mise à jour majeure**, effectuez une sauvegarde manuelle de PostgreSQL.","Un VPS professionnel pour votre gestion financière","Firefly III tourne parfaitement sur 1 Go de RAM. Nos offres professionnels offrent des VPS SSD avec snapshots quotidiens inclus — vos données financières restent chez vous, sauvegardées et accessibles partout.","Voir les offres professionnels","\u002Fsolutions\u002Fprofessionnels",[136,153,169],{"id":137,"slug":138,"slugs":139,"title":142,"excerpt":143,"readTime":144,"views":15,"isPinned":16,"publishedAt":145,"category":146,"categories":147,"featuredImage":26,"bgImage":27,"posterImage":149,"relatedSolution":150},173,"self-host-actual-budget-vps",{"fr":138,"en":140,"ar":141},"self-host-actual-budget-on-a-vps-your-private-ynab-alternative","استضافة-actual-budget-على-vps-بديل-ynab-الخاص-بك","Héberger Actual Budget sur un VPS : l’alternative privée à YNAB","Auto-hébergez Actual Budget sur un VPS : budgétisation à base zéro sous licence MIT, synchronisation bancaire, accès multi-appareils et chiffrement de bout en bout.",4,"2026-07-07T00:00:00+00:00",{"id":19,"name":20,"slug":21,"color":22,"icon":23},[148],{"id":19,"name":20,"slug":21,"color":22,"icon":23},"\u002Fblog\u002Fcovers\u002Fself-host-actual-budget-vps-poster.svg",{"categorySlug":151,"appSlug":152},"erp","actual-budget",{"id":154,"slug":155,"slugs":156,"title":159,"excerpt":160,"readTime":161,"views":15,"isPinned":16,"publishedAt":162,"category":163,"categories":164,"featuredImage":26,"bgImage":27,"posterImage":166,"relatedSolution":167},87,"heberger-listmonk",{"fr":155,"en":157,"ar":158},"host-listmonk-on-your-own-vps","استضافة-listmonk-على-خادمك-الافتراضي-الخاص-vps","Héberger Listmonk sur votre propre VPS","Envoyez vos newsletters sans abonnement mensuel : déployez Listmonk sur votre VPS avec PostgreSQL, SMTP et SSL. Guide self-hosting complet.",3,"2026-03-25T00:00:00+00:00",{"id":19,"name":20,"slug":21,"color":22,"icon":23},[165],{"id":19,"name":20,"slug":21,"color":22,"icon":23},"\u002Fblog\u002Fcovers\u002Fheberger-listmonk-poster.svg",{"categorySlug":21,"appSlug":168},"listmonk",{"id":170,"slug":171,"slugs":172,"title":175,"excerpt":176,"readTime":161,"views":15,"isPinned":16,"publishedAt":177,"category":178,"categories":184,"featuredImage":26,"bgImage":27,"posterImage":186,"relatedSolution":26},113,"sauvegardes-restic-vps",{"fr":171,"en":173,"ar":174},"automate-your-vps-backups-with-restic","أتمتة-نسخ-خادمك-vps-الاحتياطية-باستخدام-restic","Automatiser les sauvegardes de votre VPS avec Restic","Automatisez les sauvegardes de votre VPS avec Restic : snapshots chiffrés, déduplication et envoi vers S3 ou tout backend objet.","2026-02-27T00:00:00+00:00",{"id":179,"name":180,"slug":181,"color":182,"icon":183},8,"Sécurité & Monitoring","securite-monitoring","bg-rose-500\u002F10 text-rose-400","security",[185],{"id":179,"name":180,"slug":181,"color":182,"icon":183},"\u002Fblog\u002Fcovers\u002Fsauvegardes-restic-vps-poster.svg",1787580973672]