# Запустіть власний Beancount.io одним кліком

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



Beancount дає вам повну власність над вашими фінансами у вигляді простого тексту. Володіти програмним забезпеченням навколо цих файлів `.bean` було складніше: щоб отримати веб-інтерфейс, CLI та кінцеву точку для AI-агента поверх вашого журналу, доводилося або довіряти свої книги нашому хостинговому сервісу, або вручну з'єднувати шість сервісів.

Від сьогодні ви можете розгорнути власний приватний екземпляр Beancount.io одним кліком.

Натисніть **Deploy to bex.co**, виберіть робочий простір, який має володіти стеком, і підтвердьте план. Налаштовувати нічого не потрібно — кожен секрет генерується автоматично всередині вашого робочого простору. Приблизно через 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-репозиторій на диску у вашому робочому просторі. Кожен інтерфейс звертається виключно до вашої адреси, а не до нашої: веб-панель керування, CLI `bea`, агенти програмування через вбудований MCP-сервер або звичайний `git` (автентифікацію якого виконує `bea`). Немає обмежень тарифних планів на журнали, директиви чи використання AI, і стек не надсилає жодної аналітики назад до Beancount.io.

Необов'язкові інтеграції залишаються вимкненими, доки вони вам не знадобляться: власний ключ моделі для сканування квитанцій, категоризації та асистента; S3-бакет для завантаження квитанцій; або поштовий ключ для скидання пароля. Доки ви їх не додасте, кожна функція просто показує, яке налаштування їй потрібне — усе інше працює одразу.

## Що ви отримуєте і скільки це коштує

Розгортання створює шість сервісів, що оплачуються безпосередньо з вашого робочого простору bex (ціни з попереднього перегляду плану bex станом на 2026-11-18):

| Сервіс | Що він робить | Вартість на місяць (USD) |
| --- | --- | --- |
| Dashboard | Веб-застосунок і єдина публічна адреса, яку ви використовуєте | $4.90 |
| API | GraphQL, REST, MCP-сервер і Git-проксі | $4.90 |
| Ledger service | Перевіряє та запитує ваші книги (приватний, без публічної адреси) | $4.90 |
| Gitea | Зберігає кожен журнал як Git-репозиторій на диску 10 ГБ (приватний) | $6.65 |
| Postgres | Облікові записи, токени та налаштування | $4.41 |
| Key Value | Сесії входу та кеші | $7.21 |
| **Разом** | | **$32.97** |

Будь-який зовнішній постачальник моделей, поштовий сервіс або S3-бакет, які ви підключаєте, оплачуються окремо цими постачальниками.

> **Перед видаленням:** Видалення ресурсів негайно зупиняє оплату, **і разом із тим видаляє ваші дані.** Завжди спершу клонуйте ваші Git-журнали.

Кожен обліковий запис у самостійно розгорнутому стеку автоматично отримує найвищий тариф — жодних штучних обмежень:

![Settings, 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)), виберіть робочий простір, перегляньте план і застосуйте. Нічого не створюється, доки ви не підтвердите.
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)

## Спрямуйте свої інструменти на власну адресу

### CLI `bea`

Встановіть або оновіть [`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
```

Обидві змінні середовища використовують ту саму адресу панелі керування, яка проксує за вас трафік 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-раннери та скрипти)

Якщо ви не хочете встановлювати `bea` на машині чи CI-раннері, автентифікуйтеся за допомогою особистого токена доступу — так само, як у GitHub:

1. **Створіть токен.** Перейдіть у **Settings → Personal access tokens → New token**. Назвіть його за середовищем (`laptop`, `nightly-backup`), виберіть `ledger.read` для клонування/отримання змін і додайте `ledger.write`, якщо потрібно надсилати зміни. Для скриптів без нагляду обмежте його одним журналом і встановіть дату закінчення терміну дії. Негайно скопіюйте токен `bcio_...` — він показується лише один раз.

   ![Settings, 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 спершу ввімкніть помічник облікових даних: `git config --global credential.helper store` (простий текст у `~/.git-credentials`) або `credential.helper 'cache --timeout=86400'` (у пам'яті на 24 години).

Для скриптів і запланованих резервних копій тримайте токен поза віддаленим URL (щоб він не записувався в `.git/config`) і поза історією оболонки, передаючи одноразовий помічник облікових даних:

```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` ваших наявних файлів.

## Що залишає ваш робочий простір

Стек не надсилає жодної аналітики чи телеметрії до Beancount.io, а скрипт браузерної аналітики повністю вилучено зі збирання. Єдині вихідні запити, про які нам відомо:

- **Перевірка зламаних паролів:** Перші 5 символів SHA-1-хешу нового пароля перевіряються через k-анонімність (ні ваш пароль, ні ваш обліковий запис не розкриваються).
- **Аватари:** Браузерні запити до Gravatar з використанням хешу електронної адреси користувача.
- **Стрічки:** Запити до стрічок блогу та журналу змін 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, у вашому робочому просторі й за ваш рахунок. Повна прозорість: 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).

Зіткнулися з проблемою? Відкрийте [issue на GitHub](https://github.com/bex-co/beancount-io/issues) або завітайте до [чату в Telegram](https://t.me/beancount).
