Розгорніть весь стек Beancount.io — веб-застосунок, API, MCP-сервер і ваші журнали на базі Git — у власному робочому просторі bex приблизно за 30 хвилин. Жодного налаштування, без обмежень тарифних планів, ліцензія MIT і приблизно $33/місяць за хостинг.
Beancount дає вам повну власність над вашими фінансами у вигляді простого тексту. Володіти програмним забезпеченням навколо цих файлів .bean було складніше: щоб отримати веб-інтерфейс, CLI та кінцеву точку для AI-агента поверх вашого журналу, доводилося або довіряти свої книги нашому хостинговому сервісу, або вручну з'єднувати шість сервісів.
Від сьогодні ви можете розгорнути власний приватний екземпляр Beancount.io одним кліком.
Натисніть Deploy to bex.co, виберіть робочий простір, який має володіти стеком, і підтвердьте план. Налаштовувати нічого не потрібно — кожен секрет генерується автоматично всередині вашого робочого простору. Приблизно через 30 хвилин ваша панель керування буде доступна. Створіть свій обліковий запис, і реєстрація закриється за вами; ніхто інший не зможе увійти, якщо ви не запросите його через власного постачальника ідентифікації.
Ваш журнал зберігається як стандартний 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-журнали.
Кожен обліковий запис у самостійно розгорнутому стеку автоматично отримує найвищий тариф — жодних штучних обмежень:

Від одного кліку до вашого першого журналу
- Запустіть стек. Натисніть Deploy to bex.co (вище або в README), виберіть робочий простір, перегляньте план і застосуйте. Нічого не створюється, доки ви не підтвердите.
- Дочекайтеся початкового збирання. Перше збирання займає 27–30 хвилин у наших тестах (довше, якщо черга збирання bex завантажена). Якщо сервіс показує невдале розгортання, запустіть повторне розгортання з панелі керування bex.
- Привласніть свій екземпляр. Відкрийте URL вашої панелі керування та одразу зареєструйтеся — кроку підтвердження електронної пошти немає.
- Створіть журнал. Почніть з нуля за допомогою початкового шаблону або завантажте зразок журналу для ознайомлення.
Примітка щодо безпеки: Доки не створено перший обліковий запис, будь-хто, хто дізнається ваш URL, може його привласнити. Якщо хтось випередить вас, ви можете видалити цей обліковий запис за допомогою адміністративного токена стеку, щоб знову відкрити реєстрацію.

Спрямуйте свої інструменти на власну адресу
CLI bea
Встановіть або оновіть bea за допомогою uv tool install beancount-io або brew install bex-co/tap/bea, потім спрямуйте його на вашу панель керування:
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.

Агенти програмування (MCP)
Підключіть Claude Code або будь-який MCP-сумісний клієнт безпосередньо до вашого розгортання:
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 безпосередньо до журналу.

Звичайний Git
Кожен журнал — це Git-репозиторій за адресою https://<your API address>/git/<owner>/<ledger>.git (точний URL можна скопіювати з меню Git Clone журналу). Оскільки bex не маршрутизує SSH, Git працює через HTTPS — а bea бере на себе облікові дані за вас:
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 без bea (CI-раннери та скрипти)
Якщо ви не хочете встановлювати bea на машині чи CI-раннері, автентифікуйтеся за допомогою особистого токена доступу — так само, як у GitHub:
-
Створіть токен. Перейдіть у Settings → Personal access tokens → New token. Назвіть його за середовищем (
laptop,nightly-backup), виберітьledger.readдля клонування/отримання змін і додайтеledger.write, якщо потрібно надсилати зміни. Для скриптів без нагляду обмежте його одним журналом і встановіть дату закінчення терміну дії. Негайно скопіюйте токенbcio_...— він показується лише один раз.
-
Клонуйте та кешуйте. Під час першого клонування введіть будь-який непорожній рядок як ім'я користувача та вставте токен як пароль. macOS (Keychain) і Windows (Git Credential Manager) зберігають його автоматично. На Linux спершу ввімкніть помічник облікових даних:
git config --global credential.helper store(простий текст у~/.git-credentials) абоcredential.helper 'cache --timeout=86400'(у пам'яті на 24 години).
Для скриптів і запланованих резервних копій тримайте токен поза віддаленим URL (щоб він не записувався в .git/config) і поза історією оболонки, передаючи одноразовий помічник облікових даних:
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).
Дивіться повну таблицю конфіденційності з точними подробицями про те, коли виконується кожен запит.
Хто керує машинами
Ваші сервіси, диск і база даних працюють на інфраструктурі bex, у вашому робочому просторі й за ваш рахунок. Повна прозорість: bex створено компанією Stargately, Inc. — тією ж компанією, що стоїть за Beancount.io — і хостинг регулюється політикою конфіденційності та умовами надання послуг bex. Хостинговий сервіс Beancount.io повністю окремий від вашого стеку і не містить жодного з його секретів.
Волієте працювати на апаратному забезпеченні, яке ви контролюєте безпосередньо? Наше розгортання через Docker запускає точно такий самий стек на будь-якому сервері, яким ви володієте.
Варто знати
- За замовчуванням один користувач, OIDC для команд або родини. Реєстрація закривається після створення першого облікового запису. Щоб додати інших, підключіть постачальника OpenID Connect і вкажіть дозволені адреси в
OIDC_ALLOWED_EMAILS(посібник із налаштування). 2FA обробляється вашим постачальником ідентифікації. - Оновлення за вашим графіком. Ваш стек залишається закріпленим на версії, яку ви розгорнули, доки ви не вирішите синхронізувати Blueprint і повторно розгорнути стек (як оновити).
- Прості резервні копії. Журнали — це просто Git-репозиторії —
git clone --mirrorстворює резервну копію всієї вашої історії. Облікові записи, токени та налаштування зберігаються в керованому Postgres із безперервним резервним копіюванням і відновленням на момент часу (посібник із резервного копіювання). - Підтримка мобільного застосунку. На екрані вітання мобільного застосунку відкрийте налаштування, спрямуйте URL сервера на адресу вашої панелі керування та увійдіть.
Щоб отримати всі кроки в одному місці, включно з оновленнями, резервним копіюванням, скиданням пароля та видаленням стеку, дивіться посібник із самостійного розгортання.
Зіткнулися з проблемою? Відкрийте issue на GitHub або завітайте до чату в Telegram.





