What is BeeCount Cloud?

BeeCount Cloud is a self-hosted synchronization server for the BeeCount personal finance app (iOS, Android, Web). It runs as a single Docker container with a SQLite database and provides real-time WebSocket sync across devices within seconds. Features include multi-user shared ledgers with owner/editor roles, AI-assisted bookkeeping via OCR and voice, multi-remote AES-256 encrypted backups to S3/R2/WebDAV/Google Drive/OneDrive, a built-in MCP server for LLM-driven ledger queries, and a responsive web console with PWA support, dark mode, and an admin panel. The project uses a Business Source License (BSL): free for personal self-hosting, education, and open-source contributions; commercial use requires a paid license.

Should you self-host BeeCount Cloud?

BeeCount Cloud scores 46/100 on selfhost.directory (how scoring works) and ranks #34 of 62 in Personal Finance. It has 191 GitHub stars.

It shipped 10 stable releases in the past year. The latest, 1.9.0, came out on 25 October 2026. New versions land roughly every 5 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Econumo (50/100, 118 stars). It scores higher overall, so compare the two before you pick. See BeeCount Cloud vs Econumo side by side.

Features

Admin panel with live logs
AI bookkeeping (OCR/voice)
Attachment support
Automatic database migrations
Built-In MCP Server
CSV import/export
Multi-currency ledgers
Multi-remote encrypted backup
Offline-first sync
Prometheus Metrics
Real-time multi-device sync
Recurring Transactions
Rich analytics dashboard
Shared ledgers (multi-user)

How to install BeeCount Cloud

Install BeeCount Cloud with Docker

Docker

Environment variables

JWT_SECRET, DATABASE_URL, TZ, SCHEDULER_TIMEZONE, EMBEDDING_BASE_URL, EMBEDDING_MODEL, EMBEDDING_API_KEY, RAG_INDEX_REFRESH_INTERVAL_SECONDS, EXCHANGE_RATE_PROXY_ENABLED, EXCHANGE_RATE_CACHE_TTL_HOURS, EXCHANGE_RATE_UPSTREAM, PROJECT_PARTNERSHIPS_ENABLED, CORS_ORIGINS, RATE_LIMIT_WINDOW_SECONDS, RATE_LIMIT_MAX_REQUESTS, BACKUP_STORAGE_DIR, BACKUP_MAX_UPLOAD_BYTES, ALLOW_APP_RW_SCOPES

docker run -p 8080:8080 -v beecount_data:/data
-e JWT_SECRET=dev-secret-at-least-32-bytes-long
sunxiao0721/beecount-cloud:dev

Development image build from source.

How to configure BeeCount Cloud

ACCESS_TOKEN_EXPIRE_MINUTES
ALLOW_APP_RW_SCOPEStrue
API_PREFIX/api/v1
APP_ENVdevelopment
APP_NAMEBeeCount Cloud
BACKUP_MAX_UPLOAD_BYTES67108864
BACKUP_STORAGE_DIR./data/backups
CORS_ORIGINShttp://localhost:8080,http://localhost:5173,http://localhost:3000
DATABASE_URLsqlite:///./beecount.db
EMBEDDING_API_KEY
EMBEDDING_BASE_URL===== AI 文档 Q&A(可选)===== 配了就启用 ⌘K 「问 AI」(对 BeeCount-Website 的文档做 RAG)。不配也行,用户点「问 AI」时 fallback 到「跳官网搜文档」。默认走 SiliconFlow + BAAI/bge-m3,免费 quota cover 几十万次问答。注册 https://siliconflow.cn 拿 key 填进来即可。关键约束:EMBEDDING_MODEL 必须跟 BeeCount-Website 索引 build 时一致 (docker image 自带的 sqlite 默认是 BAAI/bge-m3 build 的)。换 model 必须双侧同步,见 .docs/web-cmdk-ai-doc-search.md。兼容的 provider: - SiliconFlow(默认):https://api.si
===== AI 文档 Q&A(可选)===== 配了就启用 ⌘K 「问 AI」(对 BeeCount-Website 的文档做 RAG)。不配也行,用户点「问 AI」时 fallback 到「跳官网搜文档」。默认走 SiliconFlow + BAAI/bge-m3,免费 quota cover 几十万次问答。注册 https://siliconflow.cn 拿 key 填进来即可。关键约束:EMBEDDING_MODEL 必须跟 BeeCount-Website 索引 build 时一致 (docker image 自带的 sqlite 默认是 BAAI/bge-m3 build 的)。换 model 必须双侧同步,见 .docs/web-cmdk-ai-doc-search.md。兼容的 provider: - SiliconFlow(默认):https://api.si
EMBEDDING_MODELBAAI/bge-m3
EXCHANGE_RATE_CACHE_TTL_HOURS
EXCHANGE_RATE_PROXY_ENABLED===== 汇率代理(多币种 MVP)=====
===== 汇率代理(多币种 MVP)=====
EXCHANGE_RATE_UPSTREAM可选:整体替换上游为自托管 Frankfurter(http://host:8080)
可选:整体替换上游为自托管 Frankfurter(http://host:8080)
JWT_SECRET
PROJECT_PARTNERSHIPS_ENABLEDtrue自建实例可关闭关于页商务入口和 AI 配置中的项目接入指南。
自建实例可关闭关于页商务入口和 AI 配置中的项目接入指南。
RAG_INDEX_REFRESH_INTERVAL_SECONDS21600运行时热更新官方文档索引;索引落到持久化 cache,无需重建镜像。0=关闭自动检查。
运行时热更新官方文档索引;索引落到持久化 cache,无需重建镜像。0=关闭自动检查。
RAG_INDEX_SOURCE_URL
RATE_LIMIT_MAX_REQUESTS30
RATE_LIMIT_WINDOW_SECONDS60
REFRESH_TOKEN_EXPIRE_DAYS
SCHEDULER_TIMEZONE显式配置 Cloud 时区；Docker 镜像默认 TZ=Asia/Shanghai。 MCP 无偏移量的日期 / 时间优先使用 SCHEDULER_TIMEZONE，其次 TZ。 TZ=Asia/Shanghai
显式配置 Cloud 时区；Docker 镜像默认 TZ=Asia/Shanghai。 MCP 无偏移量的日期 / 时间优先使用 SCHEDULER_TIMEZONE，其次 TZ。 TZ=Asia/Shanghai
WEB_STATIC_DIR/app/static

FAQ

Is it free?

Yes, completely free. No ads, no subscriptions, no hidden fees.

Is there an Android version?

Yes, you can download the APK from GitHub Releases.

Can I use multiple cloud sync services at once?

Currently only one cloud sync method can be selected at a time.

What if sync isn't working?

Check network connection, verify cloud service configuration, try manually triggering sync, and check sync logs for issues.

Can multiple people share a ledger?

Yes, after self-hosting BeeCount Cloud, the Owner can generate an invite code from the App or Web; family/friends enter it to join the same ledger with real-time sync and Owner/Editor roles.

Can I record investment returns?

You can create an Investment category and Investment Account to record, but automatic ROI calculation is not yet supported.

Does it support multiple currencies?

Yes, multiple currencies are supported. You can select the currency when creating a ledger, but each ledger can only use one currency.

Where is my data stored?

Data is stored locally on your device by default. When cloud sync is enabled, it syncs to your chosen cloud service. BeeCount does not collect any data.