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

D'un sol clic al teu primer llibre
- Engega la pila. Fes clic a Deploy to bex.co (a dalt, o al README), tria el teu espai de treball, revisa el pla i aplica'l. No s'aprovisiona res fins que ho aprovis.
- 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.
- 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.
- 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 amb el token d'administrador de la pila per reobrir el registre.

Apunta les teves eines a la teva pròpia adreça
La CLI bea
Instal·la o actualitza bea amb uv tool install beancount-io o brew install bex-co/tap/bea, i després apunta-la al teu tauler:
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 listTotes dues variables d'entorn utilitzen el mateix URL del tauler, que fa de proxy del trànsit de l'API per tu.

Agents de codi (MCP)
Connecta Claude Code o qualsevol client compatible amb MCP directament al teu desplegament:
claude mcp add --transport http beancount \
https://<your dashboard address>/api-gateway/mcpInicia 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.

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

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:
-
Crea un token. Ves a Configuració → Tokens d'accés personal → Token nou. Anomena'l segons el seu entorn (
laptop,nightly-backup), seleccionaledger.readper clonar i fer pull, i afegeixledger.writesi ha de fer push. Per a scripts desatesos, limita'l a un sol llibre i estableix una data de caducitat. Copia el tokenbcio_...immediatament—només es mostra una vegada.
-
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) ocredential.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:
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>.gitEl -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 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 i els termes del servei 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 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ó). 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).
- Còpies de seguretat senzilles. Els llibres són només repositoris Git—
git clone --mirrorfa 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). - 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.
Has topat amb un obstacle? Obre un issue a GitHub o passa pel xat de Telegram.





