# Executa el teu propi Beancount.io amb un sol clic

Desplega tota la pila de Beancount.io—l'aplicació web, l'API, el servidor MCP i els teus llibres recolzats per Git—al teu propi espai de treball bex en uns 30 minuts. Configuració zero, sense límits de pla, amb llicència MIT i uns 33 $/mes en allotjament.



Beancount et dona la propietat completa de les teves finances en text pla. Posseir el programari al voltant d'aquests fitxers `.bean` ha estat més difícil: tenir una interfície web, una CLI i un punt final d'agent d'IA sobre el teu llibre significava o bé confiar els teus comptes al nostre servei allotjat o bé connectar sis serveis a mà.

A partir d'avui, pots engegar la teva pròpia instància privada de Beancount.io amb un sol clic.

Prem **Deploy to bex.co**, tria l'espai de treball que ha de posseir la pila i aprova el pla. No hi ha res a configurar—cada secret es genera automàticament dins del teu espai de treball. Uns 30 minuts després, el teu tauler ja és actiu. Crea el teu compte i el registre es tanca darrere teu; ningú més no hi pot entrar tret que els convidis a través del teu propi proveïdor d'identitat.

[![Desplega a 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)

El teu llibre viu com un repositori Git estàndard en un disc del teu espai de treball. Cada interfície apunta estrictament a la teva adreça, no a la nostra: el tauler web, la CLI `bea`, els agents de codi mitjançant el servidor MCP integrat, o el simple `git` (que `bea` autentica per tu). No hi ha límits de pla en llibres, directives o ús d'IA, i la pila no envia cap analítica a Beancount.io.

Les integracions opcionals romanen desactivades fins que les necessitis: porta la teva pròpia clau de model per a l'escaneig de rebuts, la categorització i l'assistent; un bucket S3 per a la càrrega de rebuts; o una clau de correu per al restabliment de contrasenyes. Fins que les afegeixis, cada funció simplement mostra quina configuració necessita—tota la resta funciona des del primer moment.

## Què obtens i quant costa

El desplegament aprovisiona sis serveis facturats directament al teu espai de treball bex (preus de la previsualització del pla de bex del 2026-11-18):

| Servei | Què fa | Cost mensual (USD) |
| --- | --- | --- |
| Tauler | L'aplicació web i l'única adreça pública que utilitzes | 4,90 $ |
| API | GraphQL, REST, servidor MCP i el proxy de Git | 4,90 $ |
| Servei de llibre | Valida i consulta els teus comptes (privat, sense adreça pública) | 4,90 $ |
| Gitea | Emmagatzema cada llibre com un repositori Git en un disc de 10 GB (privat) | 6,65 $ |
| Postgres | Comptes, tokens i configuracions | 4,41 $ |
| Key Value | Sessions d'inici de sessió i memòries cau | 7,21 $ |
| **Total** | | **32,97 $** |

Qualsevol proveïdor de models extern, servei de correu o bucket S3 que connectis es factura per separat per part d'aquests proveïdors.

> **Abans de desmuntar-ho:** Eliminar els recursos atura la factura immediatament, **i elimina les teves dades amb ells.** Clona sempre els teus llibres Git primer.

Cada compte d'una pila autoallotjada obté automàticament el nivell superior—sense sostres artificials:

![Configuració, Facturació en una pila autoallotjada: el pla Enterprise, amb tokens d'IA, llibres, directives i col·laboradors il·limitats.](/img/blog/run-your-own-beancount-io-from-one-button/no-plan-limits.webp)

## D'un sol clic al teu primer llibre

1. **Engega la pila.** Fes clic a **Deploy to bex.co** (a dalt, o al [README](https://github.com/bex-co/beancount-io#self-host)), tria el teu espai de treball, revisa el pla i aplica'l. No s'aprovisiona res fins que ho aprovis.
2. **Espera la compilació inicial.** La primera compilació triga entre 27 i 30 minuts en les nostres proves (més si la cua de compilació de bex està ocupada). Si un servei mostra un desplegament fallit, torna a desencadenar un redesplegament des del tauler de bex.
3. **Reclama la teva instància.** Obre l'URL del teu tauler i registra't immediatament—no hi ha cap pas de verificació per correu electrònic.
4. **Crea un llibre.** Comença de nou amb la plantilla inicial o carrega el llibre d'exemple per explorar.

> **Nota de seguretat:** Fins que es crea el primer compte, qualsevol que descobreixi el teu URL pot reclamar-lo. Si algú se t'avança, pots [eliminar aquest 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) amb el token d'administrador de la pila per reobrir el registre.

![Registre en un nou desplegament autoallotjat. Al costat del formulari, la pàgina diu que aquesta còpia la gestiona el seu propietari i que els comptes són text pla a Git.](/img/blog/run-your-own-beancount-io-from-one-button/sign-up.webp)

## Apunta les teves eines a la teva pròpia adreça

### La CLI `bea`

Instal·la o actualitza [`bea`](/docs/Basics/bea-cli) amb `uv tool install beancount-io` o `brew install bex-co/tap/bea`, i després apunta-la al teu tauler:

```zsh
export BEA_API_URL=https://<your dashboard address>
export BEA_DASHBOARD_URL=https://<your dashboard address>
bea cloud login            # signs in through your browser
bea cloud ledger list
```

Totes dues variables d'entorn utilitzen el mateix URL del tauler, que fa de proxy del trànsit de l'API per tu.

![bea 0.4.1 contra un desplegament autoallotjat: bea cloud login, bea cloud status al pla Enterprise, i bea cloud ledger list.](/img/blog/run-your-own-beancount-io-from-one-button/bea-login.webp)

### Agents de codi (MCP)

Connecta Claude Code o qualsevol client compatible amb MCP directament al teu desplegament:

```zsh
claude mcp add --transport http beancount \
  https://<your dashboard address>/api-gateway/mcp
```

Inicia la sessió via `/mcp` a Claude Code—la pantalla de consentiment OAuth la serveix la teva pròpia instància. Per als clients que s'autentiquen mitjançant capçaleres, genera un token a **Configuració → Tokens d'accés personal** i passa'l com a `Authorization: Bearer <token>`. A la nostra pila de proves, un client MCP va exposar immediatament 47 eines i va executar consultes BQL directament contra el llibre.

![Un client MCP apuntat a l'adreça pròpia del desplegament amb un token d'accés personal: 47 eines, i una consulta BQL sobre el llibre.](/img/blog/run-your-own-beancount-io-from-one-button/mcp-client.webp)

### Git simple

Cada llibre és un repositori Git a `https://<your API address>/git/<owner>/<ledger>.git` (pots copiar l'URL exacte del menú **Git Clone** del llibre). Com que bex no enruta SSH, Git funciona sobre HTTPS—i `bea` gestiona les credencials per tu:

```zsh
bea cloud login            # once, if you haven't already
bea cloud git setup        # configures Git to authenticate with your bea session
git clone https://<your API address>/git/<owner>/<ledger>.git
```

A partir d'aquí, `git clone`, `git pull` i `git push` funcionen sense demanar res en aquest amfitrió, i `bea cloud logout` també esborra les credencials de Git. *(Nota: `bea cloud ledger clone` no clona directament sobre HTTPS; en servidors sense SSH, t'imprimeix aquestes ordres per tu.)*

![El menú Git Clone d'un llibre: l'adreça HTTPS de l'API, amb un token d'accés personal com a contrasenya.](/img/blog/run-your-own-beancount-io-from-one-button/git-clone-menu.webp)

#### Utilitzar Git sense `bea` (executors de CI i scripts)

Si prefereixes no instal·lar `bea` en una màquina o en un executor de CI, autentica't amb un token d'accés personal—igual que amb GitHub:

1. **Crea un token.** Ves a **Configuració → Tokens d'accés personal → Token nou**. Anomena'l segons el seu entorn (`laptop`, `nightly-backup`), selecciona `ledger.read` per clonar i fer pull, i afegeix `ledger.write` si ha de fer push. Per a scripts desatesos, limita'l a un sol llibre i estableix una data de caducitat. Copia el token `bcio_...` immediatament—només es mostra una vegada.

   ![Configuració, Tokens d'accés personal: un token amb ledger.read i ledger.write, el seu prefix, i quan es va crear i es va utilitzar per última vegada.](/img/blog/run-your-own-beancount-io-from-one-button/access-tokens.webp)

2. **Clona i desa a la memòria cau.** Al teu primer clon, introdueix qualsevol cadena no buida com a nom d'usuari i enganxa el token com a contrasenya. macOS (Keychain) i Windows (Git Credential Manager) el desen automàticament. A Linux, activa primer un ajudant de credencials: `git config --global credential.helper store` (text pla a `~/.git-credentials`) o `credential.helper 'cache --timeout=86400'` (en memòria durant 24 hores).

Per a scripts i còpies de seguretat programades, mantén el token fora de l'URL remot (perquè no s'escrigui a `.git/config`) i fora de l'historial de la teva shell passant un ajudant de credencials puntual:

```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://<your API address>/git/<owner>/<ledger>.git
```

El `-c credential.helper=` buit evita que el teu Keychain local o `~/.git-credentials` desin el token a la memòria cau. Passa totes dues opcions `-c` a qualsevol `git fetch` o `git push` posterior del teu script.

> **Resolució de problemes de credencials:** Si Git continua reintentant una contrasenya antiga o un token revocat, esborra'l amb `printf 'protocol=https\nhost=<your API address>\n\n' | git credential reject`. L'autenticació de Git per contrasenya encara funciona per ara, però s'està eliminant gradualment.

**Migrar els teus comptes existents?** Crea un llibre nou, fusiona-hi els teus fitxers o l'historial de Git, i fes push. La pila llegeix `main.bean` com a punt d'entrada, així que anomena el teu fitxer arrel `main.bean` o utilitza'l per fer `include` dels teus fitxers existents.

## Què surt del teu espai de treball

La pila no envia analítica ni telemetria a Beancount.io, i l'script d'analítica del navegador s'elimina completament de la compilació. Les úniques peticions sortints que coneixem són:

- **Verificació de filtracions de contrasenyes:** Els primers 5 caràcters del hash SHA-1 d'una contrasenya nova es verifiquen mitjançant k-anonymity (ni la teva contrasenya ni el teu compte queden exposats).
- **Avatars:** Peticions del navegador a Gravatar utilitzant un hash de l'adreça de correu electrònic de l'usuari.
- **Feeds:** Peticions als feeds del blog i del changelog de Beancount.io (només s'envia una preferència d'idioma, cap dada d'usuari).
- **Feeds de preus:** Peticions a beancount.io *només* si el teu llibre inclou explícitament un URL de preus gestionat.
- **Les teves pròpies integracions:** Dades enviades als serveis que actives (proveïdors de LLM, SendGrid, S3, Plaid o el teu proveïdor OIDC).

Consulta la [taula de privacitat completa](https://github.com/bex-co/beancount-io/blob/main/docs/prfaqs/PRFAQ006-self-host-on-bex.md#12-is-my-data-private) per als detalls exactes de quan s'activa cada petició.

## Qui executa les màquines

Els teus serveis, disc i base de dades s'executen a la infraestructura de bex, dins del teu espai de treball i a la teva factura. Plena transparència: bex està construït per Stargately, Inc.—la mateixa empresa darrere de Beancount.io—i l'allotjament es regeix per la [política de privacitat](https://bex.co/privacy-policy) i els [termes del servei](https://bex.co/terms-of-service) de bex. El servei allotjat de Beancount.io és completament independent de la teva pila i no en té cap secret.

Prefereixes executar-ho en maquinari que controlis directament? El nostre [desplegament amb Docker](https://github.com/bex-co/beancount-io/tree/main/deploy/docker) executa exactament la mateixa pila en qualsevol servidor que posseeixis.

## Bo de saber

- **Un sol usuari per defecte, OIDC per a equips o família.** El registre es tanca després de crear el primer compte. Per afegir altres persones, connecta un proveïdor OpenID Connect i llista les adreces permeses a `OIDC_ALLOWED_EMAILS` ([guia de configuració](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#more-accounts-your-own-identity-provider)). El 2FA el gestiona el teu proveïdor d'identitat.
- **Actualitzacions al teu ritme.** La teva pila queda fixada a la versió que vas desplegar fins que decideixis sincronitzar el Blueprint i tornar a desplegar ([com actualitzar](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#rolling-out-a-change)).
- **Còpies de seguretat senzilles.** Els llibres són només repositoris Git—`git clone --mirror` fa una còpia de seguretat de tot el teu historial. Els comptes, tokens i configuracions viuen a Postgres gestionat amb còpies de seguretat contínues i recuperació puntual ([guia de còpies de seguretat](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#back-up-and-restore)).
- **Suport per a l'aplicació mòbil.** A la pantalla de benvinguda de l'aplicació mòbil, obre la configuració, apunta l'URL del servidor a l'adreça del teu tauler i inicia la sessió.

Per a cada pas en un sol lloc, incloent actualitzacions, còpies de seguretat, restabliment de contrasenyes i eliminació de la pila, consulta la [guia d'autoallotjament](/docs/self-host-beancount-io).

Has topat amb un obstacle? Obre un [issue a GitHub](https://github.com/bex-co/beancount-io/issues) o passa pel [xat de Telegram](https://t.me/beancount).
