# Запустите свой собственный 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 на 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-журналы.

Каждый аккаунт в самостоятельно размещённом стеке автоматически получает максимальный тариф — никаких искусственных ограничений:

![Настройки, 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 вашей панели управления и сразу зарегистрируйтесь — шага подтверждения по email нет.
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
```

Обе переменные окружения используют один и тот же 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-раннеры и скрипты)

Если вы предпочитаете не устанавливать `bea` на машину или CI-раннер, аутентифицируйтесь с помощью персонального токена доступа — так же, как на GitHub:

1. **Создайте токен.** Перейдите в **Settings → Personal access tokens → New token**. Назовите его по его окружению (`laptop`, `nightly-backup`), выберите `ledger.read` для клонирования/pull и добавьте `ledger.write`, если нужно выполнять push. Для необслуживаемых скриптов ограничьте его одним журналом и установите дату истечения. Немедленно скопируйте токен `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 сначала включите помощник учётных данных: `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 и выполните push. Стек читает `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).
