Despliega toda la infraestructura de Beancount.io—la aplicación web, la API, el servidor MCP y tus libros respaldados por Git—en tu propio espacio de trabajo de bex en unos 30 minutos. Cero configuración, sin límites de plan, con licencia MIT y aproximadamente $33 al mes en alojamiento.
Beancount te da la propiedad total de tus finanzas en texto plano. Ser dueño del software que rodea esos archivos .bean ha sido más difícil: tener una interfaz web, una CLI y un endpoint de agentes de IA sobre tu libro mayor significaba confiar tus cuentas a nuestro servicio alojado o conectar seis servicios a mano.
A partir de hoy, puedes levantar tu propia instancia privada de Beancount.io con un solo clic.
Pulsa Deploy to bex.co, elige el espacio de trabajo que debe ser dueño de la infraestructura y aprueba el plan. No hay nada que configurar—cada secreto se genera automáticamente dentro de tu espacio de trabajo. Unos 30 minutos después, tu panel está en línea. Crea tu cuenta, y el registro se cierra detrás de ti; nadie más puede entrar a menos que los invites a través de tu propio proveedor de identidad.
Tu libro mayor vive como un repositorio Git estándar en un disco dentro de tu espacio de trabajo. Cada interfaz apunta estrictamente a tu dirección, no a la nuestra: el panel web, la CLI bea, agentes de programación mediante el servidor MCP integrado, o simplemente git (con el que bea autentica por ti). No hay límites de plan en libros mayores, directivas ni uso de IA, y la infraestructura no envía ningún dato analítico de vuelta a Beancount.io.
Las integraciones opcionales permanecen desactivadas hasta que las necesites: usa tu propia clave de modelo para el escaneo de recibos, la categorización y el asistente; un bucket de S3 para subir recibos; o una clave de correo para restablecer contraseñas. Hasta que las añadas, cada función simplemente muestra qué configuración necesita—todo lo demás funciona desde el primer momento.
Lo que obtienes y lo que cuesta
El despliegue aprovisiona seis servicios facturados directamente a tu espacio de trabajo de bex (precios de la vista previa de planes de bex del 2026-11-18):
| Servicio | Qué hace | Costo mensual (USD) |
|---|---|---|
| Dashboard | La aplicación web y la única dirección pública que usas | $4.90 |
| API | GraphQL, REST, servidor MCP y el proxy de Git | $4.90 |
| Ledger service | Valida y consulta tus cuentas (privado, sin dirección pública) | $4.90 |
| Gitea | Almacena cada libro mayor como un repositorio Git en un disco de 10 GB (privado) | $6.65 |
| Postgres | Cuentas, tokens y ajustes | $4.41 |
| Key Value | Sesiones de inicio de sesión y cachés | $7.21 |
| Total | $32.97 |
Cualquier proveedor de modelos externo, servicio de correo o bucket de S3 que conectes se factura por separado por parte de esos proveedores.
Antes de desmontarlo: Eliminar los recursos detiene la factura de inmediato, y borra tus datos con ellos. Clona siempre tus libros mayores de Git primero.
Cada cuenta en una infraestructura autoalojada obtiene el plan más alto automáticamente—sin techos artificiales:

De un clic a tu primer libro mayor
- Lanza la infraestructura. Pulsa Deploy to bex.co (arriba, o en el README), elige tu espacio de trabajo, revisa el plan y aplícalo. No se aprovisiona nada hasta que lo apruebes.
- Espera a la compilación inicial. La primera compilación tarda entre 27 y 30 minutos en nuestras pruebas (más si la cola de compilación de bex está ocupada). Si un servicio muestra un despliegue fallido, vuelve a desplegarlo desde el panel de bex.
- Reclama tu instancia. Abre la URL de tu panel y regístrate de inmediato—no hay paso de verificación por correo electrónico.
- Crea un libro mayor. Empieza de cero con la plantilla inicial, o carga el libro de ejemplo para explorar.
Nota de seguridad: Hasta que se cree la primera cuenta, cualquiera que descubra tu URL puede reclamarla. Si alguien se te adelanta, puedes eliminar esa cuenta usando el token de administrador de la infraestructura para reabrir el registro.

Apunta tus herramientas a tu propia dirección
La CLI bea
Instala o actualiza bea con uv tool install beancount-io o brew install bex-co/tap/bea, y luego apúntala a tu panel:
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 listAmbas variables de entorno usan la misma URL del panel, que hace de proxy para el tráfico de la API por ti.

Agentes de programación (MCP)
Conecta Claude Code o cualquier cliente compatible con MCP directamente a tu despliegue:
claude mcp add --transport http beancount \
https://<your dashboard address>/api-gateway/mcpInicia sesión mediante /mcp en Claude Code—la pantalla de consentimiento de OAuth la sirve tu propia instancia. Para los clientes que se autentican mediante cabeceras, genera un token en Settings → Personal access tokens y pásalo como Authorization: Bearer <token>. En nuestra infraestructura de prueba, un cliente MCP expuso de inmediato 47 herramientas y ejecutó consultas BQL directamente contra el libro mayor.

Git sin más
Cada libro mayor es un repositorio Git en https://<your API address>/git/<owner>/<ledger>.git (puedes copiar la URL exacta desde el menú Git Clone del libro mayor). Como bex no enruta SSH, Git funciona sobre HTTPS—y bea gestiona las credenciales por ti:
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 de ahí, git clone, git pull y git push funcionan sin pedir credenciales en ese host, y bea cloud logout también borra las credenciales de Git. (Nota: bea cloud ledger clone no clona directamente por HTTPS; en servidores sin SSH, imprime estos comandos por ti.)

Usar Git sin bea (runners de CI y scripts)
Si prefieres no instalar bea en una máquina o en un runner de CI, autentícate con un token de acceso personal—igual que con GitHub:
-
Crea un token. Ve a Settings → Personal access tokens → New token. Ponle un nombre según su entorno (
laptop,nightly-backup), seleccionaledger.readpara clonar y hacer pull, y añadeledger.writesi necesita hacer push. Para scripts desatendidos, limítalo a un solo libro mayor y establece una fecha de caducidad. Copia el tokenbcio_...de inmediato—solo se muestra una vez.
-
Clona y guarda en caché. En tu primer clon, introduce cualquier cadena no vacía como nombre de usuario y pega el token como contraseña. macOS (Keychain) y Windows (Git Credential Manager) lo guardan automáticamente. En Linux, habilita primero un helper de credenciales:
git config --global credential.helper store(texto plano en~/.git-credentials) ocredential.helper 'cache --timeout=86400'(en memoria durante 24 horas).
Para scripts y copias de seguridad programadas, mantén el token fuera de la URL remota (para que no se escriba en .git/config) y fuera del historial de tu shell pasando un helper de credenciales 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= vacío evita que tu Keychain local o ~/.git-credentials almacenen en caché el token. Pasa ambas opciones -c a cualquier git fetch o git push posterior en tu script.
Solución de problemas de credenciales: Si Git sigue reintentando una contraseña antigua o un token revocado, bórralo con
printf 'protocol=https\nhost=<your API address>\n\n' | git credential reject. La autenticación de Git con contraseña todavía funciona por ahora, pero se está eliminando de forma gradual.
¿Migrar tus cuentas existentes? Crea un nuevo libro mayor, fusiona tus archivos o el historial de Git en él y haz push. La infraestructura lee main.bean como punto de entrada, así que nombra tu archivo raíz main.bean o úsalo para include tus archivos existentes.
Qué sale de tu espacio de trabajo
La infraestructura no envía datos analíticos ni telemetría a Beancount.io, y el script de analítica del navegador se elimina por completo de la compilación. Las únicas solicitudes salientes que conocemos son:
- Comprobación de contraseñas filtradas: Los primeros 5 caracteres del hash SHA-1 de una nueva contraseña se comprueban mediante k-anonimidad (ni tu contraseña ni tu cuenta quedan expuestas).
- Avatares: Solicitudes del navegador a Gravatar usando un hash de la dirección de correo del usuario.
- Feeds: Solicitudes a los feeds del blog y del changelog de Beancount.io (envían solo una preferencia de idioma, sin datos del usuario).
- Fuentes de precios: Solicitudes a beancount.io solo si tu libro mayor incluye explícitamente una URL de precios gestionada.
- Tus propias integraciones: Datos enviados a servicios que actives explícitamente (proveedores de LLM, SendGrid, S3, Plaid o tu proveedor OIDC).
Consulta la tabla de privacidad completa para conocer los detalles exactos de cuándo se produce cada solicitud.
Quién ejecuta las máquinas
Tus servicios, disco y base de datos se ejecutan en la infraestructura de bex, dentro de tu espacio de trabajo y bajo tu factura. Total transparencia: bex está construido por Stargately, Inc.—la misma empresa detrás de Beancount.io—y el alojamiento se rige por la política de privacidad y los términos de servicio de bex. El servicio alojado de Beancount.io es completamente independiente de tu infraestructura y no guarda ninguno de sus secretos.
¿Prefieres ejecutarlo en hardware que controlas directamente? Nuestro despliegue con Docker ejecuta exactamente la misma infraestructura en cualquier servidor que poseas.
Conviene saber
- Un solo usuario por defecto, OIDC para equipos o familia. El registro se cierra tras crear la primera cuenta. Para añadir a otras personas, conecta un proveedor de OpenID Connect y enumera las direcciones permitidas en
OIDC_ALLOWED_EMAILS(guía de configuración). El 2FA lo gestiona tu proveedor de identidad. - Actualizaciones a tu ritmo. Tu infraestructura permanece fijada a la versión que desplegaste hasta que decidas sincronizar el Blueprint y volver a desplegar (cómo actualizar).
- Copias de seguridad sencillas. Los libros mayores son simplemente repositorios Git—
git clone --mirrorrespalda todo tu historial. Las cuentas, los tokens y los ajustes viven en Postgres gestionado con copias de seguridad continuas y recuperación a un punto en el tiempo (guía de copias de seguridad). - Compatibilidad con la aplicación móvil. En la pantalla de bienvenida de la aplicación móvil, abre los ajustes, apunta la URL del servidor a la dirección de tu panel e inicia sesión.
Para ver todos los pasos en un solo lugar, incluidas actualizaciones, copias de seguridad, restablecimiento de contraseñas y eliminación de la infraestructura, consulta la guía de autoalojamiento.
¿Te has encontrado con un problema? Abre un issue en GitHub o pásate por el chat de Telegram.





