Разверните весь стек 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 на 18.11.2026):
| Сервис | Что делает | Стоимость в месяц (USD) |
|---|---|---|
| Панель управления | Веб-приложение и единственный публичный адрес, который вы используете | $4.90 |
| API | GraphQL, REST, MCP-сервер и Git-прокси | $4.90 |
| Сервис журнала | Проверяет и запрашивает ваши книги (приватный, без публичного адреса) | $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 вашей панели управления и сразу зарегистрируйтесь — шага подтверждения по email нет.
- Создайте журнал. Начните с нуля с помощью стартового шаблона или загрузите пример журнала для ознакомления.
Примечание по безопасности: Пока не создан первый аккаунт, любой, кто обнаружит ваш 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Обе переменные окружения используют один и тот же URL панели управления, который проксирует трафик 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для клонирования/pull и добавьтеledger.write, если нужно выполнять push. Для необслуживаемых скриптов ограничьте его одним журналом и установите дату истечения. Немедленно скопируйте токен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 и выполните push. Стек читает 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.





