Self-host Sure with Levelrail

A privacy-first personal finance app for tracking net worth, budgets, and investments across every account.

  • Authorwe-promise
  • LicenceAGPL-3.0
  • Memory1 GiB
  • Archarm64
  • Services4

How to self-host Sure

  1. Pull the images

    4 images are pulled on your server.

    Show images
    • postgres:16-alpine
    • valkey/valkey:8-alpine
    • ghcr.io/we-promise/sure:0.6.7
    • ghcr.io/we-promise/sure:0.6.7
  2. Create the app

    4 services start in a single Compose app, with 4 named volume mounts for your data, on port 3000.

  3. Fill in the secrets

    5 secrets are generated and stored encrypted, 18 settings are preset, you do not have to fill in anything.

  4. Open it

    Without a domain the app gets an sslip.io address; add --domain SERVICE=HOST to use your own.

Sure requirements

Memory
About 1 GiB
Architectures
amd64 image published, arm64 image published
Ports
3000
Domain
Optional, an sslip.io address is used without one
Settings
none to fill in
License
AGPL-3.0, network copyleft (agpl) license
  • Listed. It is in the catalog but not verified. Back up the data volume before changing an image tag.
  • Host ports. It publishes port 3000 on the host, so open them in the VPS firewall only if you want that.

Install Levelrail first

On a server with Levelrail running, run the command above, or open the dashboard: Apps, New app, Browse templates, then Sure. New to Levelrail? Install it on a fresh VPS first.

docker pull ghcr.io/glincker/levelrail:latest

Then levelrail-cli login --device. See Getting started and the Sure docs page.

Deploy Sure your way

Every format below deploys the same pinned images. Pick the one that fits how you work.

Deploy Sure from the CLI

levelrail-cli templates deploy sure --name my-sure

Deploy Sure with the API

Create a token in the dashboard first. This one-click route deploys it as a trial app you can keep or remove.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  https://levelrail.example.com/api/v1/service-templates/sure/deploy

Sure configuration

Sure services

ServiceImagePortsVolumes
postgresql postgres:16-alpine none sure_postgresql_data -> /var/lib/postgresql/data
valkey valkey/valkey:8-alpine none sure_valkey_data -> /data
web ghcr.io/we-promise/sure:0.6.7 3000 sure_app_storage -> /rails/storage
worker ghcr.io/we-promise/sure:0.6.7 none sure_app_storage -> /rails/storage

Sure environment variables

VariableServiceValue
POSTGRES_DB postgresql Preset by the template
POSTGRES_PASSWORD postgresql Generated at deploy
POSTGRES_USER postgresql Preset by the template
APP_DOMAIN web Preset by the template
DB_HOST web Preset by the template
DB_PORT web Preset by the template
ONBOARDING_STATE web Preset by the template
POSTGRES_DB web Preset by the template
Show all 23 variables
  • POSTGRES_PASSWORDwebGenerated at deploy
  • POSTGRES_USERwebPreset by the template
  • RAILS_ASSUME_SSLwebPreset by the template
  • RAILS_FORCE_SSLwebPreset by the template
  • REDIS_URLwebPreset by the template
  • SECRET_KEY_BASEwebGenerated at deploy
  • SELF_HOSTEDwebPreset by the template
  • DB_HOSTworkerPreset by the template
  • DB_PORTworkerPreset by the template
  • POSTGRES_DBworkerPreset by the template
  • POSTGRES_PASSWORDworkerGenerated at deploy
  • POSTGRES_USERworkerPreset by the template
  • REDIS_URLworkerPreset by the template
  • SECRET_KEY_BASEworkerGenerated at deploy
  • SELF_HOSTEDworkerPreset by the template

Ports and volumes

Ports
3000
Volumes
4 named mounts: sure_postgresql_data -> /var/lib/postgresql/data, sure_valkey_data -> /data, sure_app_storage -> /rails/storage, sure_app_storage -> /rails/storage

Sure FAQ

How much memory does Sure need?

The catalog lists about 1 GiB of memory for Sure across its 4 services.

Does Sure run on arm64?

For Sure, an arm64 image is published; amd64 is image published.

What licence is Sure under?

Sure is licensed under AGPL-3.0, which is network copyleft, so source sharing also applies when it is offered as a hosted service.

Does Sure need configuration before it starts?

No. The template fills in its own defaults and generates secrets at deploy time.

Which database does Sure bundle?

The template includes Postgres and Redis, running as its own service.

Which ports does Sure use?

Sure listens on port 3000 inside the stack.

Where does Sure keep its data?

In named volumes: sure_postgresql_data mounted at /var/lib/postgresql/data, sure_valkey_data mounted at /data and sure_app_storage mounted at /rails/storage.

Can I deploy Sure on Dokploy or Dokku?

The services and pinned images on this page can be run on any Docker host. The public Dokploy templates list we compared does not have an entry with the same id for Sure, so on Dokploy you would use a Docker Compose application with the file from this page. Dokku deploys container images with its own commands, so the pinned image postgres:16-alpine, valkey/valkey:8-alpine, ghcr.io/we-promise/sure:0.6.7, ghcr.io/we-promise/sure:0.6.7 is what you deploy there.

levelrail-cli templates deploy sure --name my-sure