# Стартирайте своя Beancount.io с едно кликване

Разположете целия стек на Beancount.io—уеб приложението, API, MCP сървъра и вашите водени в Git книги—във вашия собствен bex workspace за около 30 минути. Без конфигурация, без ограничения на плана, с MIT лиценз и приблизително $33/месец за хостинг.



Beancount ви дава пълна собственост върху финансите ви в обикновен текст. Собствеността върху софтуера около тези `.bean` файлове обаче беше по-трудна: да имате уеб интерфейс, CLI и endpoint за AI агент върху вашата книга означаваше или да се доверите на нашия хостван сервиз с вашите сметки, или да свържете шест услуги ръчно.

От днес можете да стартирате собствен екземпляр на Beancount.io с едно кликване.

Натиснете **Deploy to bex.co**, изберете workspace, който да притежава стека, и одобрете плана. Няма нищо за конфигуриране—всяка тайна се генерира автоматично във вашия workspace. Около 30 минути по-късно таблото ви е активно. Създайте своя акаунт и регистрацията се затваря след вас; никой друг не може да влезе, освен ако не го поканите чрез вашия собствен доставчик на идентичност.

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

Вашата книга се съхранява като стандартно Git хранилище на диск във вашия workspace. Всеки интерфейс сочи строго към вашия адрес, не към нашия: уеб таблото, `bea` CLI, агентите за програмиране чрез вградения MCP сървър или обикновен `git` (който `bea` удостоверява вместо вас). Няма ограничения на плана за книги, директиви или използване на AI, а стекът не изпраща никаква аналитика обратно към Beancount.io.

Опционалните интеграции остават изключени, докато не ви потрябват: използвайте собствен ключ за модел за сканиране на разписки, категоризация и асистента; S3 bucket за качване на разписки; или пощенски ключ за нулиране на пароли. Докато не ги добавите, всяка функция просто показва коя настройка ѝ е нужна—всичко останало работи веднага.

## Какво получавате и колко струва

Разгръщането осигурява шест услуги, таксувани директно към вашия bex workspace (цени от прегледа на плана на bex към 2026-11-18):

| Услуга | Какво прави | Месечна цена (USD) |
| --- | --- | --- |
| Dashboard | Уеб приложението и единственият публичен адрес, който използвате | $4.90 |
| API | GraphQL, REST, MCP сървър и Git прокси | $4.90 |
| Ledger service | Валидира и прави заявки към вашите книги (частна, без публичен адрес) | $4.90 |
| Gitea | Съхранява всяка книга като Git хранилище на 10 GB диск (частна) | $6.65 |
| Postgres | Акаунти, токени и настройки | $4.41 |
| Key Value | Сесии за вход и кешове | $7.21 |
| **Общо** | | **$32.97** |

Всеки външен доставчик на модели, пощенска услуга или S3 bucket, който свържете, се таксува отделно от тези доставчици.

> **Преди да го премахнете:** Изтриването на ресурсите спира таксуването веднага, **и изтрива данните ви с него.** Винаги първо клонирайте вашите Git книги.

Всеки акаунт в самостоятелно хостван стек получава най-високото ниво автоматично—без изкуствени тавани:

![Настройки, Billing в самостоятелно хостван стек: планът Enterprise, с неограничени AI токени, книги, директиви и сътрудници.](/img/blog/run-your-own-beancount-io-from-one-button/no-plan-limits.webp)

## От едно кликване до първата ви книга

1. **Стартирайте стека.** Натиснете **Deploy to bex.co** (по-горе или в [README](https://github.com/bex-co/beancount-io#self-host)), изберете вашия workspace, прегледайте плана и го приложете. Нищо не се осигурява, докато не го одобрите.
2. **Изчакайте първоначалното изграждане.** Първото изграждане отнема 27–30 минути в нашите тестове (по-дълго, ако опашката за изграждане на bex е заета). Ако дадена услуга показва неуспешно разгръщане, задействайте повторно разгръщане от таблото на bex.
3. **Заявете своя екземпляр.** Отворете URL адреса на таблото си и се регистрирайте веднага—няма стъпка за потвърждение по имейл.
4. **Създайте книга.** Започнете отначало с началния шаблон или заредете примерната книга, за да разгледате.

> **Бележка за сигурност:** Докато не бъде създаден първият акаунт, всеки, който открие вашия URL адрес, може да го заяви. Ако някой ви изпревари, можете да [премахнете този акаунт](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), използвайки администраторския токен на стека, за да отворите отново регистрацията.

![Регистрация в ново самостоятелно хоствано разгръщане. До формуляра страницата казва, че това копие се управлява от собственика му и книгите са в обикновен текст в Git.](/img/blog/run-your-own-beancount-io-from-one-button/sign-up.webp)

## Насочете инструментите си към собствения си адрес

### `bea` CLI

Инсталирайте или актуализирайте [`bea`](/docs/Basics/bea-cli) чрез `uv tool install beancount-io` или `brew install bex-co/tap/bea`, след което го насочете към вашето табло:

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

И двете променливи на средата използват същия URL адрес на таблото, който проксира API трафика вместо вас.

![bea 0.4.1 срещу самостоятелно хоствано разгръщане: bea cloud login, bea cloud status на плана Enterprise и bea cloud ledger list.](/img/blog/run-your-own-beancount-io-from-one-button/bea-login.webp)

### Агенти за програмиране (MCP)

Свържете Claude Code или всеки съвместим с MCP клиент директно към вашето разгръщане:

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

Влезте чрез `/mcp` в Claude Code—екранът за съгласие на OAuth се обслужва от вашия собствен екземпляр. За клиенти, които се удостоверяват чрез хедъри вместо това, генерирайте токен под **Settings → Personal access tokens** и го предайте като `Authorization: Bearer <token>`. В нашия тестов стек MCP клиент веднага показа 47 инструмента и изпълни BQL заявки директно срещу книгата.

![MCP клиент, насочен към собствения адрес на разгръщането с личен токен за достъп: 47 инструмента и BQL заявка върху книгата.](/img/blog/run-your-own-beancount-io-from-one-button/mcp-client.webp)

### Обикновен Git

Всяка книга е Git хранилище на адрес `https://<your API address>/git/<owner>/<ledger>.git` (можете да копирате точния URL от менюто **Git Clone** на книгата). Тъй като bex не маршрутизира SSH, Git работи през HTTPS—а `bea` се грижи за идентификационните данни вместо вас:

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

Оттам нататък `git clone`, `git pull` и `git push` работят без запитване на този хост, а `bea cloud logout` изчиства и идентификационните данни на Git. *(Бележка: `bea cloud ledger clone` не клонира директно през HTTPS; на сървъри без SSH той отпечатва тези команди за вас.)*

![Менюто Git Clone на книга: HTTPS адресът на API с личен токен за достъп като парола.](/img/blog/run-your-own-beancount-io-from-one-button/git-clone-menu.webp)

#### Използване на Git без `bea` (CI runners и скриптове)

Ако предпочитате да не инсталирате `bea` на машина или CI runner, удостоверете се с личен токен за достъп—точно както с GitHub:

1. **Създайте токен.** Отидете на **Settings → Personal access tokens → New token**. Назовете го според средата му (`laptop`, `nightly-backup`), изберете `ledger.read` за клониране/изтегляне и добавете `ledger.write`, ако трябва да публикува. За автоматични скриптове ограничете обхвата му до една книга и задайте дата на изтичане. Копирайте токена `bcio_...` веднага—той се показва само веднъж.

   ![Настройки, Personal access tokens: токен с ledger.read и ledger.write, неговият префикс и кога е създаден и използван за последно.](/img/blog/run-your-own-beancount-io-from-one-button/access-tokens.webp)

2. **Клонирайте и кеширайте.** При първото клониране въведете произволен непразен низ като потребителско име и поставете токена като парола. macOS (Keychain) и Windows (Git Credential Manager) го съхраняват автоматично. В Linux първо активирайте credential helper: `git config --global credential.helper store` (обикновен текст в `~/.git-credentials`) или `credential.helper 'cache --timeout=86400'` (в паметта за 24 часа).

За скриптове и планирани архивирания дръжте токена извън отдалечения URL (за да не се записва в `.git/config`) и извън историята на shell-а, като предадете еднократен credential helper:

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

Празният `-c credential.helper=` пречи на локалния Keychain или `~/.git-credentials` да кешират токена. Предайте и двата флага `-c` на всяко следващо `git fetch` или `git push` в скрипта си.

> **Отстраняване на проблеми с идентификационни данни:** Ако Git продължава да опитва стара парола или отменен токен, изчистете го с `printf 'protocol=https\nhost=<your API address>\n\n' | git credential reject`. Удостоверяването в Git с парола все още работи засега, но постепенно се премахва.

**Мигрирате съществуващи книги?** Създайте нова книга, обединете файловете или Git историята си в нея и публикувайте. Стекът чете `main.bean` като входна точка, така че или назовете основния си файл `main.bean`, или го използвайте, за да `include` съществуващите си файлове.

## Какво напуска вашия workspace

Стекът не изпраща аналитика или телеметрия към Beancount.io, а скриптът за аналитика в браузъра е напълно премахнат от изграждането. Единствените изходящи заявки, за които знаем, са:

- **Проверки за изтекли пароли:** Първите 5 символа от SHA-1 хеша на нова парола се проверяват чрез k-анонимност (нито паролата ви, нито акаунтът ви се разкриват).
- **Аватари:** Заявки от браузъра към Gravatar, използващи хеш на имейл адреса на потребителя.
- **Емисии:** Заявки за емисиите на блога и changelog на Beancount.io (изпраща се само езикова предпочитание, без потребителски данни).
- **Емисии с цени:** Заявки към beancount.io *само* ако вашата книга изрично включва управляван URL за цени.
- **Вашите собствени интеграции:** Данни, изпращани до услуги, които сами изберете (доставчици на LLM, SendGrid, S3, Plaid или вашият OIDC доставчик).

Вижте [пълната таблица за поверителност](https://github.com/bex-co/beancount-io/blob/main/docs/prfaqs/PRFAQ006-self-host-on-bex.md#12-is-my-data-private) за точни подробности кога се задейства всяка заявка.

## Кой управлява машините

Вашите услуги, диск и база данни работят на инфраструктурата на bex, във вашия workspace и на вашата сметка. Пълна прозрачност: bex е създаден от Stargately, Inc.—същата компания зад Beancount.io—и хостингът се урежда от [политиката за поверителност](https://bex.co/privacy-policy) и [условията за ползване](https://bex.co/terms-of-service) на bex. Хостваната услуга Beancount.io е напълно отделна от вашия стек и не съдържа нито една от неговите тайни.

Предпочитате да работите на хардуер, който контролирате директно? Нашето [Docker разгръщане](https://github.com/bex-co/beancount-io/tree/main/deploy/docker) пуска абсолютно същия стек на всеки сървър, който притежавате.

## Добре е да знаете

- **Един потребител по подразбиране, OIDC за екипи или семейство.** Регистрацията се затваря след създаването на първия акаунт. За да добавите други, свържете OpenID Connect доставчик и изброете разрешените адреси в `OIDC_ALLOWED_EMAILS` ([ръководство за настройка](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#more-accounts-your-own-identity-provider)). 2FA се обработва от вашия доставчик на идентичност.
- **Актуализации по ваш график.** Вашият стек остава фиксиран към версията, която сте разположили, докато не изберете да синхронизирате Blueprint и да разположите отново ([как да актуализирате](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#rolling-out-a-change)).
- **Прави резервни копия.** Книгите са просто Git хранилища—`git clone --mirror` архивира цялата ви история. Акаунтите, токените и настройките се намират в управляван Postgres с непрекъснати резервни копия и възстановяване към точка във времето ([ръководство за архивиране](https://github.com/bex-co/beancount-io/tree/main/deploy/bex#back-up-and-restore)).
- **Поддръжка на мобилното приложение.** На екрана за добре дошли на мобилното приложение отворете настройките, насочете URL адреса на сървъра към адреса на таблото си и влезте.

За всяка стъпка на едно място, включително актуализации, архивирания, нулиране на пароли и премахване на стека, вижте [ръководството за самостоятелно хостване](/docs/self-host-beancount-io).

Сблъскахте се с проблем? Отворете [GitHub issue](https://github.com/bex-co/beancount-io/issues) или се присъединете към [Telegram чата](https://t.me/beancount).
