# Exécutez votre propre Beancount.io en un clic

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](/img/blog/run-your-own-beancount-io-from-one-button/deploy-to-bex.svg)](https://dashboard.bex.co/deploy?repo=https://github.com/bex-co/beancount-io&path=bex.yaml)

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) :

| Service | Ce qu'il fait | Coût mensuel (USD) |
| --- | --- | --- |
| Tableau de bord | L'application web et l'unique adresse publique que vous utilisez | $4.90 |
| API | GraphQL, REST, serveur MCP et proxy Git | $4.90 |
| Service de registre | Valide et interroge vos livres (privé, sans adresse publique) | $4.90 |
| Gitea | Stocke chaque registre en tant que dépôt Git sur un disque de 10 Go (privé) | $6.65 |
| Postgres | Comptes, jetons et paramètres | $4.41 |
| Key Value | Sessions 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.](/img/blog/run-your-own-beancount-io-from-one-button/no-plan-limits.webp)

## D'un clic à votre premier registre

1. **Lancer la pile.** Cliquez sur **Déployez sur bex.co** (ci, ou dans le [README](https://github.com/bex-co/beancount-io#self-host)), 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](https://github.com/bex-co/beancount-io/blob/main/docs/prfaqs/PRFAQ006-self-host-on-bex.md#13-someone-signed-up-before-me-what-now) 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.](/img/blog/run-your-own-beancount-io-from-one-button/sign-up.webp)

## Diriger vos outils vers votre propre adresse

### La CLI `bea`

Installez ou mettez à jour [`bea`](/docs/Basics/bea-cli) via `uv tool install beancount-io` ou `brew install bex-co/tap/bea`, puis pointez-la vers votre tableau de bord :

```zsh
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.](/img/blog/run-your-own-beancount-io-from-one-button/bea-login.webp)

### Agents de codage (MCP)

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

```zsh
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.](/img/blog/run-your-own-beancount-io-from-one-button/mcp-client.webp)

### 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 :

```zsh
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.](/img/blog/run-your-own-beancount-io-from-one-button/git-clone-menu.webp)

#### 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.](/img/blog/run-your-own-beancount-io-from-one-button/access-tokens.webp)

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 :

```zsh
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](https://github.com/bex-co/beancount-io/blob/main/docs/prfaqs/PRFAQ006-self-host-on-bex.md#12-is-my-data-private) 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é](https://bex.co/privacy-policy) et les [conditions d'utilisation](https://bex.co/terms-of-service) 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](https://github.com/bex-co/beancount-io/tree/main/deploy/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](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#more-accounts-your-own-identity-provider)). 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](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#rolling-out-a-change)).
- **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](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#back-up-and-restore)).
- **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](/docs/self-host-beancount-io).

Vous rencontrez un problème ? Ouvrez un [problème GitHub](https://github.com/bex-co/beancount-io/issues) ou rejoignez le [chat Telegram](https://t.me/beancount).
