# Ejecuta tu propio Beancount.io con un clic

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.

[![Deploy to 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)

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:

![Settings, Billing en una infraestructura autoalojada: el plan Enterprise, con tokens de IA, libros mayores, directivas y colaboradores ilimitados.](/img/blog/run-your-own-beancount-io-from-one-button/no-plan-limits.webp)

## De un clic a tu primer libro mayor

1. **Lanza la infraestructura.** Pulsa **Deploy to bex.co** (arriba, o en el [README](https://github.com/bex-co/beancount-io#self-host)), elige tu espacio de trabajo, revisa el plan y aplícalo. No se aprovisiona nada hasta que lo apruebes.
2. **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.
3. **Reclama tu instancia.** Abre la URL de tu panel y regístrate de inmediato—no hay paso de verificación por correo electrónico.
4. **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](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) usando el token de administrador de la infraestructura para reabrir el registro.

![Registro en un nuevo despliegue autoalojado. Junto al formulario, la página indica que esta copia es ejecutada por su dueño y que las cuentas son texto plano en Git.](/img/blog/run-your-own-beancount-io-from-one-button/sign-up.webp)

## Apunta tus herramientas a tu propia dirección

### La CLI `bea`

Instala o actualiza [`bea`](/docs/Basics/bea-cli) con `uv tool install beancount-io` o `brew install bex-co/tap/bea`, y luego apúntala a tu panel:

```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
```

Ambas variables de entorno usan la misma URL del panel, que hace de proxy para el tráfico de la API por ti.

![bea 0.4.1 contra un despliegue autoalojado: bea cloud login, bea cloud status en el plan Enterprise y bea cloud ledger list.](/img/blog/run-your-own-beancount-io-from-one-button/bea-login.webp)

### Agentes de programación (MCP)

Conecta Claude Code o cualquier cliente compatible con MCP directamente a tu despliegue:

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

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

![Un cliente MCP apuntando a la dirección propia del despliegue con un token de acceso personal: 47 herramientas y una consulta BQL sobre el libro mayor.](/img/blog/run-your-own-beancount-io-from-one-button/mcp-client.webp)

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

```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 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.)*

![El menú Git Clone de un libro mayor: la dirección HTTPS de la API, con un token de acceso personal como contraseña.](/img/blog/run-your-own-beancount-io-from-one-button/git-clone-menu.webp)

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

1. **Crea un token.** Ve a **Settings → Personal access tokens → New token**. Ponle un nombre según su entorno (`laptop`, `nightly-backup`), selecciona `ledger.read` para clonar y hacer pull, y añade `ledger.write` si necesita hacer push. Para scripts desatendidos, limítalo a un solo libro mayor y establece una fecha de caducidad. Copia el token `bcio_...` de inmediato—solo se muestra una vez.

   ![Settings, Personal access tokens: un token con ledger.read y ledger.write, su prefijo, y cuándo se creó y se usó por última vez.](/img/blog/run-your-own-beancount-io-from-one-button/access-tokens.webp)

2. **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`) o `credential.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:

```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=` 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](https://github.com/bex-co/beancount-io/blob/main/docs/prfaqs/PRFAQ006-self-host-on-bex.md#12-is-my-data-private) 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](https://bex.co/privacy-policy) y los [términos de servicio](https://bex.co/terms-of-service) 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](https://github.com/bex-co/beancount-io/tree/main/deploy/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](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#more-accounts-your-own-identity-provider)). 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](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#rolling-out-a-change)).
- **Copias de seguridad sencillas.** Los libros mayores son simplemente repositorios Git—`git clone --mirror` respalda 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](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#back-up-and-restore)).
- **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](/docs/self-host-beancount-io).

¿Te has encontrado con un problema? Abre un [issue en GitHub](https://github.com/bex-co/beancount-io/issues) o pásate por el [chat de Telegram](https://t.me/beancount).
