# Start je eigen Beancount.io met één klik

Implementeer de volledige Beancount.io-stack—de webapp, API, MCP-server en je Git-gebaseerde grootboeken—in je eigen bex-workspace in ongeveer 30 minuten. Geen configuratie, geen limieten op abonnementen, MIT-licentie en ongeveer $33/maand aan hosting.



Beancount geeft je volledig eigenaarschap over je financiën in platte tekst. Eigenaar zijn van de software rond die `.bean`-bestanden was lastiger: een web-UI, CLI en AI-agent-endpoint bovenop je grootboek betekende óf vertrouwen op onze gehoste service voor je boekhouding, óf zes services handmatig aan elkaar knopen.

Vanaf vandaag kun je met één klik je eigen privé-Beancount.io-instantie opzetten.

Klik op **Deploy to bex.co**, kies de workspace die de stack moet beheren en keur het plan goed. Er valt niets te configureren—elk geheim wordt automatisch gegenereerd in je workspace. Ongeveer 30 minuten later is je dashboard live. Maak je account aan, en de registratie sluit zich achter je; niemand anders komt binnen tenzij je hen uitnodigt via je eigen identity provider.

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

Je grootboek leeft als een standaard Git-repository op een schijf in je workspace. Elke interface verwijst strikt naar jouw adres, niet het onze: het webdashboard, de `bea` CLI, coding agents via de ingebouwde MCP-server, of gewoon `git` (waarvoor `bea` de authenticatie voor je regelt). Er zijn geen limieten op abonnementen voor grootboeken, directives of AI-gebruik, en de stack stuurt nul analytics terug naar Beancount.io.

Optionele integraties blijven uit tot je ze nodig hebt: gebruik je eigen modelsleutel voor bonnetjes scannen, categoriseren en de assistent; een S3-bucket voor het uploaden van bonnetjes; of een mailsleutel voor wachtwoordresets. Tot je ze toevoegt, toont elke functie simpelweg welke instelling deze nodig heeft—al het andere werkt direct uit de doos.

## Wat je krijgt, en wat het kost

De implementatie voorziet zes services die direct worden gefactureerd aan je bex-workspace (prijzen uit bex's plan-preview van 2026-11-18):

| Service | Wat het doet | Maandelijkse kosten (USD) |
| --- | --- | --- |
| Dashboard | De webapp en het enige publieke adres dat je gebruikt | $4,90 |
| API | GraphQL, REST, MCP-server en de Git-proxy | $4,90 |
| Ledger-service | Valideert en bevraagt je boekhouding (privé, geen publiek adres) | $4,90 |
| Gitea | Slaat elk grootboek op als Git-repo op een schijf van 10 GB (privé) | $6,65 |
| Postgres | Accounts, tokens en instellingen | $4,41 |
| Key Value | Inlogsessies en caches | $7,21 |
| **Totaal** | | **$32,97** |

Elke externe modelprovider, mailservice of S3-bucket die je koppelt, wordt afzonderlijk door die providers gefactureerd.

> **Voordat je het afbreekt:** Het verwijderen van de resources stopt de factuur onmiddellijk, **en verwijdert je gegevens mee.** Kloon altijd eerst je Git-grootboeken.

Elk account op een zelf-gehoste stack krijgt automatisch het hoogste niveau—geen kunstmatige plafonds:

![Instellingen, Facturering op een zelf-gehoste stack: het Enterprise-plan, met onbeperkte AI-tokens, grootboeken, directives en medewerkers.](/img/blog/run-your-own-beancount-io-from-one-button/no-plan-limits.webp)

## Van één klik naar je eerste grootboek

1. **Start de stack.** Klik op **Deploy to bex.co** (hierboven, of in de [README](https://github.com/bex-co/beancount-io#self-host)), kies je workspace, bekijk het plan en pas het toe. Er wordt niets ingericht tot je het goedkeurt.
2. **Wacht op de eerste build.** De eerste build duurt 27–30 minuten in onze tests (langer als de buildwachtrij van bex druk is). Als een service een mislukte rollout toont, start dan een nieuwe deployment vanuit het bex-dashboard.
3. **Claim je instantie.** Open je dashboard-URL en registreer je onmiddellijk—er is geen e-mailverificatiestap.
4. **Maak een grootboek aan.** Begin fris met de startersjabloon, of laad het voorbeeldgrootboek om te verkennen.

> **Veiligheidsopmerking:** Tot het eerste account is aangemaakt, kan iedereen die je URL ontdekt deze claimen. Als iemand je voor is, kun je [dat account verwijderen](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) met de admin-token van de stack om de registratie weer te openen.

![Registratie op een nieuwe zelf-gehoste implementatie. Naast het formulier staat op de pagina dat deze kopie door de eigenaar wordt beheerd en dat de boekhouding platte tekst in Git is.](/img/blog/run-your-own-beancount-io-from-one-button/sign-up.webp)

## Richt je tools op je eigen adres

### De `bea` CLI

Installeer of update [`bea`](/docs/Basics/bea-cli) via `uv tool install beancount-io` of `brew install bex-co/tap/bea`, en richt het dan op je dashboard:

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

Beide omgevingsvariabelen gebruiken dezelfde dashboard-URL, die het API-verkeer voor je proxyt.

![bea 0.4.1 tegen een zelf-gehoste implementatie: bea cloud login, bea cloud status op het Enterprise-plan, en bea cloud ledger list.](/img/blog/run-your-own-beancount-io-from-one-button/bea-login.webp)

### Coding agents (MCP)

Verbind Claude Code of een andere MCP-compatibele client direct met je implementatie:

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

Log in via `/mcp` in Claude Code—het OAuth-toestemmingsscherm wordt door je eigen instantie geserveerd. Voor clients die via headers authenticeren, genereer je een token onder **Instellingen → Persoonlijke toegangstokens** en geef je dit door als `Authorization: Bearer <token>`. Op onze teststack stelde een MCP-client onmiddellijk 47 tools beschikbaar en voerde BQL-query's rechtstreeks tegen het grootboek uit.

![Een MCP-client gericht op het eigen adres van de implementatie met een persoonlijk toegangstoken: 47 tools, en een BQL-query over het grootboek.](/img/blog/run-your-own-beancount-io-from-one-button/mcp-client.webp)

### Gewone Git

Elk grootboek is een Git-repository op `https://<your API address>/git/<owner>/<ledger>.git` (je kunt de exacte URL kopiëren uit het **Git Clone**-menu van het grootboek). Omdat bex geen SSH routeert, draait Git over HTTPS—en `bea` regelt de inloggegevens voor je:

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

Vanaf dat punt werken `git clone`, `git pull` en `git push` zonder prompt op die host, en `bea cloud logout` wist ook Git's inloggegevens. *(Let op: `bea cloud ledger clone` kloont niet rechtstreeks via HTTPS; op servers zonder SSH toont het deze commando's voor je.)*

![Het Git Clone-menu van een grootboek: het HTTPS-adres van de API, met een persoonlijk toegangstoken als wachtwoord.](/img/blog/run-your-own-beancount-io-from-one-button/git-clone-menu.webp)

#### Git gebruiken zonder `bea` (CI-runners en scripts)

Als je liever geen `bea` installeert op een machine of CI-runner, authenticeer dan met een persoonlijk toegangstoken—net als bij GitHub:

1. **Maak een token aan.** Ga naar **Instellingen → Persoonlijke toegangstokens → Nieuw token**. Geef het een naam voor de omgeving (`laptop`, `nightly-backup`), selecteer `ledger.read` voor klonen/pullen, en voeg `ledger.write` toe als er gepusht moet worden. Beperk het voor onbeheerde scripts tot één grootboek en stel een vervaldatum in. Kopieer het `bcio_...`-token onmiddellijk—het wordt slechts één keer getoond.

   ![Instellingen, Persoonlijke toegangstokens: een token met ledger.read en ledger.write, het prefix, en wanneer het is aangemaakt en laatst gebruikt.](/img/blog/run-your-own-beancount-io-from-one-button/access-tokens.webp)

2. **Klonen en cachen.** Voer bij je eerste clone een willekeurige niet-lege string in als gebruikersnaam en plak het token als wachtwoord. macOS (Keychain) en Windows (Git Credential Manager) slaan het automatisch op. Op Linux schakel je eerst een credential helper in: `git config --global credential.helper store` (platte tekst in `~/.git-credentials`) of `credential.helper 'cache --timeout=86400'` (in het geheugen voor 24 uur).

Houd het token voor scripts en geplande back-ups buiten de remote-URL (zodat het niet in `.git/config` wordt geschreven) en buiten je shellgeschiedenis door een eenmalige credential helper door te geven:

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

De lege `-c credential.helper=` voorkomt dat je lokale Keychain of `~/.git-credentials` het token cachet. Geef beide `-c`-flags door aan elke volgende `git fetch` of `git push` in je script.

> **Problemen met inloggegevens oplossen:** Als Git blijft proberen met een oud wachtwoord of ingetrokken token, wis het dan met `printf 'protocol=https\nhost=<your API address>\n\n' | git credential reject`. Git-authenticatie op basis van wachtwoorden werkt voorlopig nog, maar wordt uitgefaseerd.

**Bestaande boekhouding migreren?** Maak een nieuw grootboek aan, voeg je bestanden of Git-geschiedenis erin samen en push. De stack leest `main.bean` als toegangspunt, dus noem je rootbestand `main.bean` of gebruik het om je bestaande bestanden te `include`-en.

## Wat je workspace verlaat

De stack stuurt geen analytics of telemetrie naar Beancount.io, en het analytics-script in de browser is volledig uit de build verwijderd. De enige uitgaande verzoeken die we kennen zijn:

- **Controle op datalekken bij wachtwoorden:** De eerste 5 tekens van de SHA-1-hash van een nieuw wachtwoord worden gecontroleerd via k-anonimiteit (noch je wachtwoord noch je account wordt blootgesteld).
- **Avatars:** Browserverzoeken naar Gravatar met een hash van het e-mailadres van de gebruiker.
- **Feeds:** Verzoeken voor de blog- en changelog-feeds van Beancount.io (verstuurt alleen een taalvoorkeur, geen gebruikersgegevens).
- **Prijsfeeds:** Verzoeken naar beancount.io *alleen* als je grootboek expliciet een beheerde prijs-URL bevat.
- **Je eigen integraties:** Gegevens die worden verzonden naar services waarvoor je kiest (LLM-providers, SendGrid, S3, Plaid of je OIDC-provider).

Zie de [volledige privacy-tabel](https://github.com/bex-co/beancount-io/blob/main/docs/prfaqs/PRFAQ006-self-host-on-bex.md#12-is-my-data-private) voor exacte details over wanneer elk verzoek plaatsvindt.

## Wie de machines draait

Je services, schijf en database draaien op de infrastructuur van bex, binnen je workspace en op jouw rekening. Volledige transparantie: bex wordt gebouwd door Stargately, Inc.—hetzelfde bedrijf achter Beancount.io—en hosting valt onder bex's [privacybeleid](https://bex.co/privacy-policy) en [servicevoorwaarden](https://bex.co/terms-of-service). De gehoste Beancount.io-service staat volledig los van je stack en bevat geen van de geheimen ervan.

Draai je liever op hardware die je direct zelf beheert? Onze [Docker-implementatie](https://github.com/bex-co/beancount-io/tree/main/deploy/docker) draait exact dezelfde stack op elke server die je bezit.

## Goed om te weten

- **Standaard voor één gebruiker, OIDC voor teams of familie.** De registratie sluit nadat het eerste account is aangemaakt. Om anderen toe te voegen, koppel je een OpenID Connect-provider en vermeld je toegestane adressen in `OIDC_ALLOWED_EMAILS` ([installatiehandleiding](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#more-accounts-your-own-identity-provider)). 2FA wordt afgehandeld door je identity provider.
- **Updates op je eigen schema.** Je stack blijft vastgezet op de versie die je hebt geïmplementeerd tot je ervoor kiest de Blueprint te synchroniseren en opnieuw te implementeren ([hoe je updatet](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#rolling-out-a-change)).
- **Eenvoudige back-ups.** Grootboeken zijn gewoon Git-repo's—`git clone --mirror` maakt een back-up van je volledige geschiedenis. Accounts, tokens en instellingen leven in beheerde Postgres met continue back-ups en point-in-time recovery ([back-uphandleiding](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#back-up-and-restore)).
- **Ondersteuning voor de mobiele app.** Open op het welkomstscherm van de mobiele app de instellingen, richt de server-URL op je dashboardadres en log in.

Voor elke stap op één plek, inclusief updates, back-ups, wachtwoordresets en het verwijderen van de stack, zie de [self-hostinghandleiding](/docs/self-host-beancount-io).

Loop je ergens tegenaan? Open een [GitHub-issue](https://github.com/bex-co/beancount-io/issues) of kom langs in de [Telegram-chat](https://t.me/beancount).
