Nasaďte celý balík Beancount.io – webovú aplikáciu, API, MCP server a svoje účtovné knihy uložené v Git – do vlastného pracovného priestoru bex približne za 30 minút. Žiadna konfigurácia, žiadne limity plánu, licencia MIT a približne 33 USD mesačne za hosting.
Beancount vám dáva plné vlastníctvo nad vašimi financiami v podobe čistého textu. Vlastniť softvér okolo týchto súborov .bean však bolo náročnejšie: získať webové rozhranie, CLI a endpoint pre AI agentov nad vašou účtovnou knihou znamenalo buď zveriť svoje knihy našej hostovanej službe, alebo ručne pospájať šesť služieb.
Od dnešného dňa si môžete spustiť vlastnú súkromnú inštanciu Beancount.io jedným kliknutím.
Stlačte Deploy to bex.co, vyberte pracovný priestor, ktorý má balík vlastniť, a schváľte plán. Nie je čo konfigurovať – každý tajný údaj sa automaticky vygeneruje vo vašom pracovnom priestore. Približne o 30 minút je váš dashboard spustený. Vytvorte si účet a registrácia sa za vami uzamkne; nikto iný sa nedostane dnu, pokiaľ ho nepozve cez vášho vlastného poskytovateľa identity.
Vaša účtovná kniha žije ako štandardný Git repozitár na disku vo vašom pracovnom priestore. Každé rozhranie ukazuje výlučne na vašu adresu, nie na našu: webový dashboard, CLI bea, kódovací agenti cez vstavaný MCP server alebo obyčajný git (ktorý za vás overí bea). Neexistujú žiadne limity plánu na účtovné knihy, direktívy ani využívanie AI a balík neposiela na Beancount.io žiadnu analytiku.
Voliteľné integrácie zostávajú vypnuté, kým ich nebudete potrebovať: prineste si vlastný kľúč k modelu na skenovanie dokladov, kategorizáciu a asistenta; S3 bucket na nahrávanie dokladov; alebo kľúč k mailovej službe na resetovanie hesla. Kým ich nepridáte, každá funkcia jednoducho zobrazí, ktoré nastavenie potrebuje – všetko ostatné funguje hneď po nasadení.
Čo dostanete a koľko to stojí
Nasadenie zriadi šesť služieb účtovaných priamo vášmu pracovnému priestoru bex (ceny z náhľadu plánu bex k 18. 11. 2026):
| Služba | Čo robí | Mesačné náklady (USD) |
|---|---|---|
| Dashboard | Webová aplikácia a jediná verejná adresa, ktorú používate | 4,90 $ |
| API | GraphQL, REST, MCP server a Git proxy | 4,90 $ |
| Služba účtovnej knihy | Validuje a dotazuje sa na vaše knihy (súkromná, bez verejnej adresy) | 4,90 $ |
| Gitea | Ukladá každú účtovnú knihu ako Git repozitár na 10 GB disku (súkromná) | 6,65 $ |
| Postgres | Účty, tokeny a nastavenia | 4,41 $ |
| Key Value | Prihlasovacie relácie a vyrovnávacie pamäte | 7,21 $ |
| Spolu | 32,97 $ |
Akýkoľvek externý poskytovateľ modelu, mailová služba alebo S3 bucket, ktorý pripojíte, sa účtuje samostatne u týchto poskytovateľov.
Predtým, než to zrušíte: Odstránenie zdrojov okamžite zastaví účtovanie, a zároveň s ním vymaže vaše dáta. Vždy najprv naklonujte svoje Git účtovné knihy.
Každý účet v samohostovanom balíku automaticky získa najvyššiu úroveň – žiadne umelé stropy:

Od jedného kliknutia k vašej prvej účtovnej knihe
- Spustite balík. Kliknite na Deploy to bex.co (vyššie alebo v README), vyberte pracovný priestor, skontrolujte plán a potvrďte. Nič sa nezriadi, kým to neschválite.
- Počkajte na počiatočné zostavenie. Prvé zostavenie trvá v našich behoch 27–30 minút (dlhšie, ak je fronta zostavení bex zaneprázdnená). Ak niektorá služba hlási zlyhané nasadenie, spustite opätovné nasadenie z dashboardu bex.
- Získajte svoju inštanciu. Otvorte adresu svojho dashboardu a okamžite sa zaregistrujte – krok overenia e-mailom neexistuje.
- Vytvorte účtovnú knihu. Začnite od nuly zo štartovacej šablóny alebo na prieskum načítajte vzorovú účtovnú knihu.
Bezpečnostná poznámka: Kým nie je vytvorený prvý účet, ktokoľvek, kto objaví vašu URL, si ju môže nárokovať. Ak vás niekto predbehne, môžete odstrániť ten účet pomocou administrátorského tokenu balíka a znova otvoriť registráciu.

Namierte svoje nástroje na vlastnú adresu
CLI bea
Nainštalujte alebo aktualizujte bea cez uv tool install beancount-io alebo brew install bex-co/tap/bea, potom ho namierte na svoj 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 listObe premenné prostredia používajú rovnakú adresu dashboardu, ktorá za vás proxuje prevádzku API.

Kódovací agenti (MCP)
Pripojte Claude Code alebo akéhokoľvek klienta kompatibilného s MCP priamo k svojmu nasadeniu:
claude mcp add --transport http beancount \
https://<your dashboard address>/api-gateway/mcpPrihláste sa cez /mcp v Claude Code – obrazovku súhlasu OAuth obsluhuje vaša vlastná inštancia. Pre klientov, ktorí sa overujú cez hlavičky, vygenerujte token v časti Settings → Personal access tokens a odovzdajte ho ako Authorization: Bearer <token>. V našom testovacom balíku MCP klient okamžite sprístupnil 47 nástrojov a spúšťal BQL dotazy priamo nad účtovnou knihou.

Obyčajný Git
Každá účtovná kniha je Git repozitár na adrese https://<your API address>/git/<owner>/<ledger>.git (presnú URL môžete skopírovať z ponuky Git Clone danej účtovnej knihy). Keďže bex nesmeruje SSH, Git beží cez HTTPS – a bea za vás spravuje prihlasovacie údaje:
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>.gitOdvtedy fungujú git clone, git pull a git push bez výzvy na danom hostiteľovi a bea cloud logout vymaže aj prihlasovacie údaje Gitu. (Poznámka: bea cloud ledger clone neklonuje priamo cez HTTPS; na serveroch bez SSH vám vypíše tieto príkazy.)

Používanie Gitu bez bea (CI runnery a skripty)
Ak radšej nechcete inštalovať bea na stroj alebo CI runner, overte sa osobným prístupovým tokenom – rovnako ako na GitHube:
-
Vytvorte token. Prejdite do Settings → Personal access tokens → New token. Pomenujte ho podľa prostredia (
laptop,nightly-backup), vyberteledger.readna klonovanie/načítavanie a pridajteledger.write, ak potrebuje odosielať zmeny. Pre skripty bez obsluhy ho obmedzte na jednu účtovnú knihu a nastavte dátum vypršania. Hneď skopírujte tokenbcio_...– zobrazí sa iba raz.
-
Naklonujte a uložte do vyrovnávacej pamäte. Pri prvom klonovaní zadajte ako používateľské meno ľubovoľný neprázdny reťazec a ako heslo vložte token. macOS (Keychain) a Windows (Git Credential Manager) ho uložia automaticky. Na Linuxe najprv povoľte pomocníka pre prihlasovacie údaje:
git config --global credential.helper store(čistý text v~/.git-credentials) alebocredential.helper 'cache --timeout=86400'(v pamäti na 24 hodín).
Pre skripty a plánované zálohy držte token mimo URL vzdialeného repozitára (aby sa nezapísal do .git/config) aj mimo histórie shellu tým, že odovzdáte jednorazového pomocníka pre prihlasovacie údaje:
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>.gitPrázdny -c credential.helper= zabráni tomu, aby váš lokálny Keychain alebo ~/.git-credentials token uložili do vyrovnávacej pamäte. Odovzdajte oba príkazy -c aj každému následnému git fetch alebo git push vo vašom skripte.
Riešenie problémov s prihlasovacími údajmi: Ak Git stále opakuje staré heslo alebo zrušený token, vymažte ho pomocou
printf 'protocol=https\nhost=<your API address>\n\n' | git credential reject. Overovanie Gitu heslom zatiaľ funguje, ale postupne sa vyraďuje.
Migrujete existujúce knihy? Vytvorte novú účtovnú knihu, zlúčte do nej svoje súbory alebo históriu Gitu a odošlite zmeny. Balík číta main.bean ako vstupný bod, takže buď pomenujte svoj koreňový súbor main.bean, alebo ho použite na include svojich existujúcich súborov.
Čo opúšťa váš pracovný priestor
Balík neposiela na Beancount.io žiadnu analytiku ani telemetriu a skript webovej analytiky je zo zostavenia úplne odstránený. Jediné odchádzajúce požiadavky, o ktorých vieme, sú:
- Kontroly úniku hesiel: Prvých 5 znakov SHA-1 hashu nového hesla sa overuje cez k-anonymitu (neodhalí sa ani vaše heslo, ani váš účet).
- Avatary: Požiadavky prehliadača na Gravatar s použitím hashu e-mailovej adresy používateľa.
- Kanály: Požiadavky na kanály blogu a changelogu Beancount.io (posiela sa iba jazyková preferencia, žiadne používateľské údaje).
- Kanály cien: Požiadavky na beancount.io iba vtedy, ak vaša účtovná kniha výslovne obsahuje spravovanú URL ceny.
- Vaše vlastné integrácie: Údaje odosielané službám, ktoré si dobrovoľne zapnete (poskytovatelia LLM, SendGrid, S3, Plaid alebo váš poskytovateľ OIDC).
Presné podrobnosti o tom, kedy sa každá požiadavka spustí, nájdete v úplnej tabuľke súkromia.
Kto prevádzkuje stroje
Vaše služby, disk a databáza bežia na infraštruktúre bex, vo vašom pracovnom priestore a na váš účet. Pre úplnú transparentnosť: bex vyvíja Stargately, Inc. – tá istá spoločnosť, ktorá stojí za Beancount.io – a hosting sa riadi zásadami ochrany súkromia a podmienkami služby bex. Hostovaná služba Beancount.io je od vášho balíka úplne oddelená a nevlastní žiadne jeho tajné údaje.
Radšej to prevádzkujete na hardvéri, ktorý priamo ovládate? Naše nasadenie cez Docker spúšťa presne ten istý balík na akomkoľvek serveri, ktorý vlastníte.
Dobre vedieť
- Predvolene pre jedného používateľa, OIDC pre tímy alebo rodinu. Registrácia sa po vytvorení prvého účtu uzavrie. Ak chcete pridať ďalších, pripojte poskytovateľa OpenID Connect a uveďte povolené adresy v
OIDC_ALLOWED_EMAILS(sprievodca nastavením). 2FA zabezpečuje váš poskytovateľ identity. - Aktualizácie podľa vášho harmonogramu. Váš balík zostáva pripnutý na verziu, ktorú ste nasadili, kým sa nerozhodnete synchronizovať Blueprint a znova nasadiť (ako aktualizovať).
- Jednoduché zálohy. Účtovné knihy sú len Git repozitáre –
git clone --mirrorzálohuje celú vašu históriu. Účty, tokeny a nastavenia žijú v spravovanom Postgrese s nepretržitými zálohami a obnovou k ľubovoľnému bodu v čase (sprievodca zálohovaním). - Podpora mobilnej aplikácie. Na uvítacej obrazovke mobilnej aplikácie otvorte nastavenia, namierte URL servera na adresu svojho dashboardu a prihláste sa.
Všetky kroky na jednom mieste vrátane aktualizácií, záloh, resetovania hesla a odstránenia balíka nájdete v sprievodcovi samohostovaním.
Narazili ste na problém? Otvorte issue na GitHube alebo sa pripojte do Telegram chatu.





