Sign inSign up

afadil/wealthfolio

By afadil

β€’Updated 7 days ago

A beautiful, open-source investment portfolio tracker that respects your privacy and your data.

Image
0

100K+

afadil/wealthfolio repository overview

⁠Wealthfolio β€” Docker Deployment

πŸ“„ 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. Both wealthfolio/wealthfolio (new primary) and afadil/wealthfolio (legacy mirror) receive the same build from CI on every release.


⁠⚠️ The image runs as a non-root user

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

β πŸš€ Quickstart

# 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.


⁠🐳 Docker Compose

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

.env gotcha: Compose interpolates $ in .env files. Single-quote the Argon2 hash: WF_AUTH_PASSWORD_HASH='$argon2id$v=19$...'


β βš™οΈ Environment Variables

VariableRequiredDescription
WF_LISTEN_ADDRyesBind address + port. Use 0.0.0.0:8088 in Docker.
WF_DB_PATHyesSQLite path (e.g. /data/wealthfolio.db).
WF_SECRET_KEYyes32-byte key. Generate with openssl rand -base64 32. Lose it = lose secrets.
WF_AUTH_PASSWORD_HASHyesΒΉArgon2id PHC string for login.
WF_AUTH_REQUIREDnoSet false if a reverse proxy handles auth. Default true.
WF_AUTH_TOKEN_TTL_MINUTESnoJWT lifetime in minutes. Default 60.
WF_CORS_ALLOW_ORIGINSyesΒΉComma-separated origins. Must match the URL in your browser bar exactly.
WF_REQUEST_TIMEOUT_MSnoHTTP timeout in ms. Default 30000.

ΒΉ Required when WF_AUTH_REQUIRED=true (the default).


β πŸ” Operational notes

  • Back up the volume β€” it holds both the SQLite DB and the encrypted secrets file. Losing WF_SECRET_KEY means losing all stored broker / API credentials.
  • Always run behind TLS (Caddy, Nginx, Traefik) for non-local deployments.
  • WF_CORS_ALLOW_ORIGINS must exactly match the address-bar URL (scheme + host + port).
  • Update: docker compose pull && docker compose up -d.
  • Built-in health check at /api/v1/healthz.

⁠🏷️ Tags

  • latest β€” newest stable release
  • vX.Y.Z β€” pinned semver (recommended for production)
  • vX.Y β€” auto-updated to the latest patch in that minor
  • sha-<commit> β€” exact commit (long SHA)

Multi-arch: linux/amd64, linux/arm64.

Tag summary

Content type

Image

Digest

sha256:6600feaa0…

Size

66 MB

Last updated

7 days ago

docker pull afadil/wealthfolio