# Spustite si vlastné Beancount.io jedným kliknutím

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.

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

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:

![Nastavenia, fakturácia v samohostovanom balíku: plán Enterprise s neobmedzeným počtom AI tokenov, účtovných kníh, direktív a spolupracovníkov.](/img/blog/run-your-own-beancount-io-from-one-button/no-plan-limits.webp)

## Od jedného kliknutia k vašej prvej účtovnej knihe

1. **Spustite balík.** Kliknite na **Deploy to bex.co** (vyššie alebo v [README](https://github.com/bex-co/beancount-io#self-host)), vyberte pracovný priestor, skontrolujte plán a potvrďte. Nič sa nezriadi, kým to neschválite.
2. **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.
3. **Získajte svoju inštanciu.** Otvorte adresu svojho dashboardu a okamžite sa zaregistrujte – krok overenia e-mailom neexistuje.
4. **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](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) pomocou administrátorského tokenu balíka a znova otvoriť registráciu.

![Registrácia v novom samohostovanom nasadení. Vedľa formulára stránka uvádza, že túto kópiu prevádzkuje jej vlastník a knihy sú v Gite uložené ako čistý text.](/img/blog/run-your-own-beancount-io-from-one-button/sign-up.webp)

## Namierte svoje nástroje na vlastnú adresu

### CLI `bea`

Nainštalujte alebo aktualizujte [`bea`](/docs/Basics/bea-cli) cez `uv tool install beancount-io` alebo `brew install bex-co/tap/bea`, potom ho namierte na svoj 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
```

Obe premenné prostredia používajú rovnakú adresu dashboardu, ktorá za vás proxuje prevádzku API.

![bea 0.4.1 voči samohostovanému nasadeniu: bea cloud login, bea cloud status v pláne Enterprise a bea cloud ledger list.](/img/blog/run-your-own-beancount-io-from-one-button/bea-login.webp)

### Kódovací agenti (MCP)

Pripojte Claude Code alebo akéhokoľvek klienta kompatibilného s MCP priamo k svojmu nasadeniu:

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

Prihlá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.

![MCP klient namierený na vlastnú adresu nasadenia s osobným prístupovým tokenom: 47 nástrojov a BQL dotaz nad účtovnou knihou.](/img/blog/run-your-own-beancount-io-from-one-button/mcp-client.webp)

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

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

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

![Ponuka Git Clone účtovnej knihy: HTTPS adresa API s osobným prístupovým tokenom ako heslom.](/img/blog/run-your-own-beancount-io-from-one-button/git-clone-menu.webp)

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

1. **Vytvorte token.** Prejdite do **Settings → Personal access tokens → New token**. Pomenujte ho podľa prostredia (`laptop`, `nightly-backup`), vyberte `ledger.read` na klonovanie/načítavanie a pridajte `ledger.write`, ak potrebuje odosielať zmeny. Pre skripty bez obsluhy ho obmedzte na jednu účtovnú knihu a nastavte dátum vypršania. Hneď skopírujte token `bcio_...` – zobrazí sa iba raz.

   ![Nastavenia, osobné prístupové tokeny: token s ledger.read a ledger.write, jeho prefix a kedy bol vytvorený a naposledy použitý.](/img/blog/run-your-own-beancount-io-from-one-button/access-tokens.webp)

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

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

Prá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](https://github.com/bex-co/beancount-io/blob/main/docs/prfaqs/PRFAQ006-self-host-on-bex.md#12-is-my-data-private).

## 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](https://bex.co/privacy-policy) a [podmienkami služby](https://bex.co/terms-of-service) 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](https://github.com/bex-co/beancount-io/tree/main/deploy/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](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#more-accounts-your-own-identity-provider)). 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ť](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#rolling-out-a-change)).
- **Jednoduché zálohy.** Účtovné knihy sú len Git repozitáre – `git clone --mirror` zá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](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#back-up-and-restore)).
- **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](/docs/self-host-beancount-io).

Narazili ste na problém? Otvorte [issue na GitHube](https://github.com/bex-co/beancount-io/issues) alebo sa pripojte do [Telegram chatu](https://t.me/beancount).
