Aller au contenu principal

Exécutez votre propre Beancount.io en un clic

Publié Dernière mise à jour 11 minutes de lectureMike ThriftMike Thrift
Exécutez votre propre Beancount.io en un clic
Sur cette page

Déployez toute la pile Beancount.io — l'application web, l'API, le serveur MCP et vos registres basés sur Git — dans votre propre espace de travail bex en environ 30 minutes. Configuration zéro, pas de limites de plan, licence MIT et environ 33 $ par mois pour l'hébergement.

Beancount vous confère une pleine propriété de vos finances en texte brut. Posséder le logiciel entourant ces fichiers .bean a été plus difficile : obtenir une interface web, une CLI et un point de terminaison d'agent IA au-dessus de votre registre signifia soit faire confiance à notre service hébergé avec vos livres, soit configurer six services manuellement.

Dès aujourd'hui, vous pouvez démarrer votre propre instance privée de Beancount.io en un seul clic.

Appuyez sur Déployez sur bex.co, choisissez l'espace de travail qui doit posséder la pile et approuvez le plan. Il n'y a rien à configurer — chaque secret est généré automatiquement à l'intérieur de votre espace de travail. Environ 30 minutes plus tard, votre tableau de bord est en ligne. Créez votre compte, et l'inscription disparaît derrière vous ; personne d'autre ne peut y accéder sauf si vous les invitez via votre propre fournisseur d'identité.

Déployez sur bex.co

Votre registre vit comme un dépôt Git standard sur un disque dans votre espace de travail. Chaque interface pointe strictement vers votre adresse, pas la nôtre : le tableau de bord web, la CLI bea, les agents de codage via le serveur MCP intégré, ou le simple git (que bea authentifie pour vous). Il n'y a aucune limite de plan pour les registres, les directives ou l'utilisation de l'IA, et la pile n'envoie aucune donnée d'analyse à Beancount.io.

Les intégrations optionnelles restent désactivées jusqu'à ce dont vous avez besoin : apportez votre propre clé de modèle pour la numérisation des reçus, la catégorisation et l'assistant ; un bucket S3 pour le téléversement des reçus ; ou une clé mail pour réinitialiser les mots de passe. Tant que vous ne les ajoutez pas, chaque fonctionnalité indique simplement quel paramètre elle nécessite — tout le reste fonctionne dès la première utilisation.

Ce que vous obtenez, et ce que cela coûte​

Le déploiement provisionne six services facturés directement à votre espace de travail bex (prix tirés de l'aperçu du plan de bex au 2026-11-18) :

ServiceCe qu'il faitCoût mensuel (USD)
Tableau de bordL'application web et l'unique adresse publique que vous utilisez$4.90
APIGraphQL, REST, serveur MCP et proxy Git$4.90
Service de registreValide et interroge vos livres (privé, sans adresse publique)$4.90
GiteaStocke chaque registre en tant que dépôt Git sur un disque de 10 Go (privé)$6.65
PostgresComptes, jetons et paramètres$4.41
Key ValueSessions de connexion et caches$7.21
Total$32.97

Tout fournisseur de modèle externe, service de messagerie ou bucket S3 auquel vous vous connectez est facturé séparément par ces prestataires.

Avant de tout supprimer : La suppression des ressources interrompt immédiatement la facturation, et supprime vos données avec elles. Clone toujours vos registres Git au préalable.

Chaque compte sur une pile auto-hébergée bénéficie automatiquement du niveau le plus élevé — aucun plafond artificiel :

Paramètres, Facturation sur une pile auto-hébergée : le plan Entreprise, avec jetons IA, registres, directives et collaborateurs illimités.

D'un clic à votre premier registre​

  1. Lancer la pile. Cliquez sur Déployez sur bex.co (ci, ou dans le README), sélectionnez votre espace de travail, examinez le plan et appliquez. Rien n'est provisionné avant votre approbation.
  2. Attendre la première construction. La première construction prend 27 à 30 minutes dans nos environnements (plus longtemps si la file d'attente de construction de bex est chargée). Si un service affiche un déploiement échoué, déclenchez un redéploiement depuis le tableau de bord bex.
  3. Réclamer votre instance. Ouvrez l'URL de votre tableau de bord et inscrivez-vous immédiatement — il n'y a pas d'étape de vérification par e-mail.
  4. Créer un registre. Commencez avec le modèle de démarrage ou chargez le registre d'exemple pour explorer.

Note de sécurité : Tant que le premier compte n'est pas créé, toute personne découvrant votre URL peut le réclamer. Si quelqu'un vous devance, vous pouvez supprimer ce compte en utilisant le jeton d'administrateur de la pile pour rouvrir l'inscription.

Inscription sur un nouveau déploiement auto-hébergé. À côté du formulaire, la page indique que ce copie est exécuté par son propriétaire et les livres sont en texte brut dans Git.

Diriger vos outils vers votre propre adresse​

La CLI bea​

Installez ou mettez à jour bea via uv tool install beancount-io ou brew install bex-co/tap/bea, puis pointez-la vers votre tableau de bord :

export BEA_API_URL=https://<votre adresse de tableau de bord>
export BEA_DASHBOARD_URL=https://<votre adresse de tableau de bord>
bea cloud login            # se connecte via votre navigateur
bea cloud ledger list

Les deux variables d'environnement utilisent la même URL de tableau de bord, qui fait proxifier le trafic API pour vous.

bea 0.4.1 contre un déploiement auto-hébergé : bea cloud login, bea cloud status sur le plan Enterprise, et bea cloud ledger list.

Agents de codage (MCP)​

Connectez Claude Code ou n'importe quel client compatible MCP directement à votre déploiement :

claude mcp add --transport http beancount \
  https://<votre adresse de tableau de bord>/api-gateway/mcp

Connectez-vous via /mcp dans Claude Code — l'écran de consentement OAuth est servi par votre propre instance. Pour les clients qui s'authentifient via des en-têtes au lieu de cela, générez un jeton sous Paramètres → jetons d'accès personnels et transmettez-le sous Authorization: Bearer <token>. Sur notre pile de test, un client MCP a immédiatement exposé 47 outils et exécuté des requêtes BQL directement contre le registre.

Un client MCP pointé vers l'adresse du déploiement avec un jeton d'accès personnel : 47 outils et une requête BQL sur le registre.

Git brut​

Chaque registre est un dépôt Git à https://<votre adresse API>/git/<owner>/<ledger>.git (vous pouvez copier l'URL exacte dans le menu Cloner Git du registre). Parce que bex ne route pas SSH, Git fonctionne via HTTPS — et bea gère les identifiants pour vous :

bea cloud login            # une seule fois, si ce n'est pas déjà fait
bea cloud git setup        # configure Git pour s'authentifier avec votre session bea
git clone https://<votre adresse API>/git/<owner>/<ledger>.git

À partir de là, git clone, git pull et git push fonctionnent sans invite sur cet hôte, et bea cloud logout supprime les identifiants Git. (Note : bea cloud ledger clone ne clone pas directement via HTTPS ; sur les serveurs sans SSH, il affiche ces commandes pour vous.)

Menu Cloner Git d'un registre : l'adresse HTTPS de l'API, avec un jeton d'accès personnel comme mot de passe.

Utiliser Git sans bea (Exécuteurs CI et scripts)​

Si vous préférez ne pas installer bea sur une machine ou un exécuteur CI, authentifiez-vous avec un jeton d'accès personnel — tout comme sur GitHub :

  1. Créer un jeton. Allez dans Paramètres → jetons d'accès personnels → Nouveau jeton. Donnez-lui un nom pour son environnement (ordinateur portable, sauvegarde nocturne), sélectionnez ledger.read pour le clonage/le tir, et ajoutez ledger.write s'il doit pousser. Pour les scripts non supervisés, limitez-le à un seul registre et définissez une date d'expiration. Copiez le jeton bcio_... immédiatement — il n'est affiché qu'une seule fois.

    Paramètres, jetons d'accès personnels : un jeton avec ledger.read et ledger.write, son préfix, et quand il a été créé et utilisé pour la dernière fois.

  2. Cloner et mettre en cache. Lors de votre premier clonage, entrez n'importe quelle chaîne non vide comme nom d'utilisateur et collez le jeton comme mot de passe. macOS (Keychain) et Windows (Gestionnaire d'informations d'identification Git) le stockent automatiquement. Sur Linux, activez d'abord un aide aux informations d'identification : git config --global credential.helper store (texte brut dans ~/.git-credentials) ou credential.helper 'cache --timeout=86400' (en mémoire pendant 24 heures).

Pour les scripts et les sauvegardes planifiées, gardez le jeton hors de l'URL distante (afin qu'il ne soit pas écrit dans .git/config) et hors de l'historique de votre shell en passant un aide aux informations d'identification unique :

read -rs BEANCOUNT_TOKEN; export BEANCOUNT_TOKEN
helper='!f() { echo username=token; echo "password=$BEANCOUNT_TOKEN"; }; f'
git -c credential.helper= -c credential.helper="$helper" \
  clone --mirror https://<votre adresse API>/git/<owner>/<ledger>.git

L'option vide -c credential.helper= empêche votre trousseau local ou ~/.git-credentials de mettre en cache le jeton. Passez les deux drapeaux -c à toute opération git fetch ou git push ultérieure dans votre script.

Dépannage des identifiants : Si Git continue de réessayer un ancien mot de passe ou un jeton révoqué, supprimez-le avec printf 'protocol=https\nhost=<votre adresse API>\n\n' | git credential reject. L'authentification Git basée sur le mot de passe fonctionne encore pour le moment, mais elle est en cours de retrait.

Migrer des livres existants ? Créez un nouveau registre, fusionnez vos fichiers ou l'historique Git dans celui-ci, puis poussez. La pile lit main.bean comme point d'entrée, donc nommez votre fichier racine main.bean ou utilisez-le pour include vos fichiers existants.

Ce qui quitte votre espace de travail​

La pile n'envoie aucune donnée d'analyse ou de télémétrie à Beancount.io, et le script d'analyse du navigateur est entièrement retiré de la construction. Les seules requêtes sortantes dont nous sommes conscients sont :

  • Vérifications de piratage de mots de passe : Les 5 premiers caractères du hachage SHA-1 d'un nouveau mot de passe sont vérifiés via la k-anonymité (ni votre mot de passe ni votre compte ne sont exposés).
  • Avatars : Requêtes de navigateur à Gravatar en utilisant un hachage de l'adresse e-mail de l'utilisateur.
  • Flux : Requêtes pour les flux de blog et de journal des modifications de Beancount.io (n'envoie qu'une préférence linguistique, aucune donnée utilisateur).
  • Flux de prix : Requêtes vers beancount.io uniquement si votre registre inclut explicitement une URL de prix gérée.
  • Vos propres intégrations : Données envoyées aux services auxquels vous souscrivez (fournisseurs de LLM, SendGrid, S3, Plaid ou votre fournisseur OIDC).

Consultez le tableau de confidentialité complet pour les détails exacts sur le déclenchement de chaque requête.

Qui fait fonctionner les machines​

Vos services, disques et bases de données fonctionnent sur l'infrastructure de bex, à l'intérieur de votre espace de travail et à votre charge. Transparence totale : bex est construit par Stargately, Inc. — la même entreprise derrière Beancount.io — et l'hébergement est régi par la politique de confidentialité et les conditions d'utilisation de bex. Le service Beancount.io hébergé est complètement séparé de votre pile et ne contient aucun de ses secrets.

Préférez fonctionner sur du matériel que vous contrôlez directement ? Notre déploiement Docker exécute exactement la même pile sur n'importe quel serveur dont vous êtes propriétaire.

Bon à savoir​

  • Par défaut pour un utilisateur, OIDC pour les équipes ou la famille. L'inscription se ferme après la création du premier compte. Pour ajouter d'autres personnes, connectez un fournisseur OpenID Connect et listez les adresses autorisées dans OIDC_ALLOWED_EMAILS (guide de configuration). La double authentification (2FA) est gérée par votre fournisseur d'identité.
  • Mises à jour selon votre calendrier. Votre pile reste bloquée sur la version que vous avez déployée jusqu'à ce que vous choisissiez de synchroniser le Blueprint et de redéployé (comment mettre à jour).
  • Sauvegardes simples. Les registres ne sont que des dépôts Git — git clone --mirror sauvegarde tout votre historique. Les comptes, jetons et paramètres vivent dans Postgres géré avec des sauvegardes continues et une récupération instantanée (guide de sauvegarde).
  • Support pour application mobile. Sur l'écran de bienvenue de l'application mobile, ouvrez les paramètres, pointez l'URL du serveur vers l'adresse de votre tableau de bord et connectez-vous.

Pour chaque étape au même endroit, y compris les mises à jour, les sauvegardes, les réinitialisations de mot de passe et la suppression de la pile, consultez le guide d'auto-hébergement.

Vous rencontrez un problème ? Ouvrez un problème GitHub ou rejoignez le chat Telegram.

Source : https://beancount.io/fr/blog/2026/11/18/run-your-own-beancount-io-from-one-button

Publié: 18 novembre 2026

Dernière mise à jour: 19 novembre 2026