Skip to main content

Sure with Docker Compose

Sure runs as one image, ghcr.io/we-promise/sure, started twice: once as the Rails web server on port 3000 and once as the Sidekiq worker. Both need PostgreSQL, Redis, the same SECRET_KEY_BASE and three ACTIVE_RECORD_ENCRYPTION_* keys. Set the keys before you create the first account. Adding them later locks existing accounts out.

Sure is the community fork of Maybe Finance, whose repository was archived in July 2025.

Before using the one-click template, here is a minimal Docker Compose example for self-hosting Sure.

If you're new to Docker Compose, check out our guide on how to self-host a Docker Compose app. More stacks are in our Docker Compose library.

Self-host Sure with Docker Compose (minimal)​

services:
web:
image: ghcr.io/we-promise/sure:stable
ports:
- "3000:3000"
environment:
SECRET_KEY_BASE: changeme_generate_a_long_random_hex_string
DB_HOST: db
DB_PORT: 5432
POSTGRES_DB: sure_production
POSTGRES_USER: sure_user
POSTGRES_PASSWORD: changeme
REDIS_URL: redis://redis:6379/1
SELF_HOSTED: "true"
ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY: changeme_32_random_alphanumerics
ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY: changeme_32_random_alphanumerics
ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT: changeme_32_random_alphanumerics
volumes:
- app-storage:/rails/storage
depends_on:
- db
- redis

worker:
image: ghcr.io/we-promise/sure:stable
command: bundle exec sidekiq
volumes:
- app-storage:/rails/storage
environment:
SECRET_KEY_BASE: changeme_generate_a_long_random_hex_string
DB_HOST: db
DB_PORT: 5432
POSTGRES_DB: sure_production
POSTGRES_USER: sure_user
POSTGRES_PASSWORD: changeme
REDIS_URL: redis://redis:6379/1
SELF_HOSTED: "true"
ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY: changeme_32_random_alphanumerics
ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY: changeme_32_random_alphanumerics
ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT: changeme_32_random_alphanumerics
depends_on:
- db
- redis

db:
image: postgres:16
environment:
POSTGRES_DB: sure_production
POSTGRES_USER: sure_user
POSTGRES_PASSWORD: changeme
volumes:
- postgres-data:/var/lib/postgresql/data

redis:
image: redis:latest

volumes:
app-storage:
postgres-data:
warning

Set the three ACTIVE_RECORD_ENCRYPTION_* keys before you create your first account. Without them, Sure stores emails, names, MFA secrets, API keys and bank tokens in plaintext — the app warns about this on boot and under Settings → Security. Adding the keys later silences the warning but locks existing accounts out, because the encrypted email lookup no longer matches the plaintext rows. Generate a set with bin/rails db:encryption:init, or use any 32-character random strings, and keep them stable afterwards.

Hostim.dev's one-click template generates all three keys for you at deploy time.

note

Sure requires the same SECRET_KEY_BASE on both the web and worker processes — the Sidekiq worker needs it to decrypt data written by the web app. Hostim's one-click template runs both processes in a single container so this is handled for you automatically.


Deploy Sure on Hostim.dev (One-Click)​

Sure is an open-source, self-hosted personal finance and budgeting app — track accounts, net worth, and spending without handing your financial data to a third party. With Hostim.dev, you can deploy Sure with Docker, managed PostgreSQL and Redis in one click – complete with automatic domain and HTTPS.

💰 Your money, your data, your server.

Try it Yourself

Guest project runs for 1 hour. Log in to save and extend to 5 days.

Why Host Sure on Hostim.dev?​

  • One-click Docker deployment
  • Managed PostgreSQL and Redis, no setup required
  • Background job processing (Sidekiq) runs alongside the app automatically
  • Automatic HTTPS and domain
  • Real-time logs and metrics
  • Fully self-hosted and private

What's included​

ResourceDetails
Appghcr.io/we-promise/sure Docker image, web + Sidekiq worker in one container
DatabaseManaged PostgreSQL
CacheManaged Redis
Volume/rails/storage
EncryptionACTIVE_RECORD_ENCRYPTION_* keys generated per deploy
DomainFree *.hostim.dev subdomain
SSLLet's Encrypt (auto-enabled)
Port3000

How to Deploy​

  1. Go to your Hostim.dev dashboard.
  2. Click Create Project → Use a Template.
  3. Select Sure.
  4. Choose a resource plan.
  5. Deploy.
  6. Open your app's domain and create your first account.

FAQ​

Frequently asked questions

Which Docker image does Sure use?

ghcr.io/we-promise/sure. The :stable tag follows releases. The same image runs the web server (bin/rails server, port 3000) and the background worker (bundle exec sidekiq).

Does Sure need PostgreSQL and Redis?

Yes, both. PostgreSQL holds all accounts and transactions. Redis is the Sidekiq queue for account syncs, imports and scheduled tasks. SQLite and MySQL are not supported.

Do the web and worker containers need the same secrets?

Yes. SECRET_KEY_BASE and the three ACTIVE_RECORD_ENCRYPTION_* keys must be identical on both, or the worker cannot read data the web app wrote. The Hostim template runs both processes in one container, so they always share them.

What happens if I add the encryption keys after the first account?

Existing accounts stop logging in. The email lookup is encrypted once the keys exist, and it no longer matches the plaintext rows written before. Set the keys before the first signup and never change them. The Hostim template generates them at deploy time.

Where is my financial data stored?

In PostgreSQL, plus uploaded files in the /rails/storage volume. Nothing goes to a third party unless you enable an optional integration such as the AI assistant or a bank data provider.

Is the AI assistant enabled by default?

No. It needs an external API token that is not set by default. The app works fully without it.

How do I back up and update Sure?

Back up the PostgreSQL database and the /rails/storage volume. To update with Docker, run docker compose pull && docker compose up -d. On Hostim.dev, redeploy the app. Migrations run automatically on boot.


Alternatives​

  • Actual Budget — simpler, envelope-budgeting focused
  • Firefly III — mature, more manual bookkeeping-style tool
  • Spreadsheets — the thing you're trying to stop using

Source + Docs​


Looking for something else? Browse all templates →


Try it now​

Deploy Sure Now – in less than 60 seconds