A beautiful, open-source investment portfolio tracker that respects your privacy and your data.
100K+
π Official self-hosting guide: https://wealthfolio.app/docs/guide/self-hosting/β
π Website: https://wealthfolio.appβ
π Source: https://github.com/wealthfolio/wealthfolioβ
Wealthfolio is a privacy-first, open-source portfolio tracker. This image runs
the web edition β multi-arch (linux/amd64, linux/arm64) β that you can
self-host on any Docker host, NAS, or VPS.
Migrating from
afadil/wealthfolio? That tag still works. Bothwealthfolio/wealthfolio(new primary) andafadil/wealthfolio(legacy mirror) receive the same build from CI on every release.
UID/GID 1000:1000. Named Docker volumes work out of the box. Bind mounts must be writable by UID 1000:
mkdir -p ./data && sudo chown -R 1000:1000 ./data
Upgrading from an older image (data was owned by root)? Run once before starting the new container:
# Named volume
docker run --rm -v <your-volume>:/data alpine chown -R 1000:1000 /data
# Bind mount
sudo chown -R 1000:1000 /path/to/your/data
# 32-byte secret key β generate once, BACK THIS UP
WF_SECRET_KEY=$(openssl rand -base64 32)
# Argon2id password hash β replace 'your-password' and use a 16+ char salt
WF_AUTH_PASSWORD_HASH=$(printf 'your-password' | argon2 yoursalt16chars! -id -e)
docker run -d \
--name wealthfolio \
-e WF_LISTEN_ADDR=0.0.0.0:8088 \
-e WF_DB_PATH=/data/wealthfolio.db \
-e WF_SECRET_KEY="$WF_SECRET_KEY" \
-e WF_AUTH_PASSWORD_HASH="$WF_AUTH_PASSWORD_HASH" \
-e WF_CORS_ALLOW_ORIGINS=http://localhost:8088 \
-p 8088:8088 \
-v wealthfolio-data:/data \
wealthfolio/wealthfolio:latest
Open http://localhost:8088β and log in with the password you hashed.
services:
wealthfolio:
image: wealthfolio/wealthfolio:latest
container_name: wealthfolio
restart: unless-stopped
ports:
- "8088:8088"
volumes:
- wealthfolio-data:/data
environment:
WF_LISTEN_ADDR: "0.0.0.0:8088"
WF_DB_PATH: "/data/wealthfolio.db"
WF_SECRET_KEY: "${WF_SECRET_KEY:?Set WF_SECRET_KEY}"
WF_AUTH_PASSWORD_HASH: "${WF_AUTH_PASSWORD_HASH:?Set WF_AUTH_PASSWORD_HASH}"
WF_CORS_ALLOW_ORIGINS: "${WF_CORS_ALLOW_ORIGINS}"
healthcheck:
test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://127.0.0.1:8088/api/v1/healthz"]
interval: 30s
timeout: 10s
retries: 3
start_period: 15s
volumes:
wealthfolio-data:
docker compose up -d
.envgotcha: Compose interpolates$in.envfiles. Single-quote the Argon2 hash:WF_AUTH_PASSWORD_HASH='$argon2id$v=19$...'
| Variable | Required | Description |
|---|---|---|
WF_LISTEN_ADDR | yes | Bind address + port. Use 0.0.0.0:8088 in Docker. |
WF_DB_PATH | yes | SQLite path (e.g. /data/wealthfolio.db). |
WF_SECRET_KEY | yes | 32-byte key. Generate with openssl rand -base64 32. Lose it = lose secrets. |
WF_AUTH_PASSWORD_HASH | yesΒΉ | Argon2id PHC string for login. |
WF_AUTH_REQUIRED | no | Set false if a reverse proxy handles auth. Default true. |
WF_AUTH_TOKEN_TTL_MINUTES | no | JWT lifetime in minutes. Default 60. |
WF_CORS_ALLOW_ORIGINS | yesΒΉ | Comma-separated origins. Must match the URL in your browser bar exactly. |
WF_REQUEST_TIMEOUT_MS | no | HTTP timeout in ms. Default 30000. |
ΒΉ Required when WF_AUTH_REQUIRED=true (the default).
WF_SECRET_KEY means losing all stored broker / API
credentials.WF_CORS_ALLOW_ORIGINS must exactly match the address-bar URL (scheme +
host + port).docker compose pull && docker compose up -d./api/v1/healthz.latest β newest stable releasevX.Y.Z β pinned semver (recommended for production)vX.Y β auto-updated to the latest patch in that minorsha-<commit> β exact commit (long SHA)Multi-arch: linux/amd64, linux/arm64.
Content type
Image
Digest
sha256:6600feaa0β¦
Size
66 MB
Last updated
7 days ago
docker pull afadil/wealthfolio