Naar hoofdinhoud springen

Start je eigen Beancount.io met één klik

Gepubliceerd Laatst bijgewerkt 9 min leestijdMike ThriftMike Thrift
Start je eigen Beancount.io met één klik
Op deze pagina

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

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

ServiceWat het doetMaandelijkse kosten (USD)
DashboardDe webapp en het enige publieke adres dat je gebruikt$4,90
APIGraphQL, REST, MCP-server en de Git-proxy$4,90
Ledger-serviceValideert en bevraagt je boekhouding (privé, geen publiek adres)$4,90
GiteaSlaat elk grootboek op als Git-repo op een schijf van 10 GB (privé)$6,65
PostgresAccounts, tokens en instellingen$4,41
Key ValueInlogsessies 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.

Van één klik naar je eerste grootboek​

  1. Start de stack. Klik op Deploy to bex.co (hierboven, of in de README), 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 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.

Richt je tools op je eigen adres​

De bea CLI​

Installeer of update bea via uv tool install beancount-io of brew install bex-co/tap/bea, en richt het dan op je dashboard:

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.

Coding agents (MCP)​

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

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.

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:

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.

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.

  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:

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 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 en servicevoorwaarden. 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 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). 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).
  • 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).
  • 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.

Loop je ergens tegenaan? Open een GitHub-issue of kom langs in de Telegram-chat.

Bron: https://beancount.io/nl/blog/2026/11/18/run-your-own-beancount-io-from-one-button

Gepubliceerd: 18 november 2026

Laatst bijgewerkt: 19 november 2026