Back to Wealthfolio

Wealthfolio on Unraid

docs/self-host/unraid/README.md

3.4.01.6 KB
Original Source

Wealthfolio on Unraid

Wealthfolio runs as a standard Docker container managed through Unraid's Docker tab. The Community Apps (CA) template lives next to this README at template.xml. CA fetches it directly from the repo.

šŸ“˜ Full setup guide: wealthfolio.app/docs/guide/self-hosting

Getting started

From Community Apps (one-click)

Apps tab → search for Wealthfolio → Install → fill in WF_SECRET_KEY, WF_AUTH_PASSWORD_HASH, WF_CORS_ALLOW_ORIGINS → Apply.

Manual sideload

If CA hasn't picked up the latest template yet, sideload it from this repo. SSH into Unraid (or use the WebTerminal) and run:

bash
mkdir -p /boot/config/plugins/dockerMan/templates-user
curl -fsSL \
  https://raw.githubusercontent.com/wealthfolio/wealthfolio/main/docs/self-host/unraid/template.xml \
  -o /boot/config/plugins/dockerMan/templates-user/my-wealthfolio.xml

Then Docker → Add Container → Template → User templates → wealthfolio.

See the website guide for required values, the password hash recipe, reverse proxy setup, backups, and troubleshooting.

Permissions

The image runs as a non-root user (UID 1000) by default. The Unraid template overrides this via --user=99:100 in <ExtraParams> so the container matches Unraid's standard nobody:users appdata ownership — fresh installs work without any host-side chown.

Upgrading from an older image (pre-v3.4.0): existing data was written as root:root. Run once on the Unraid host:

bash
chown -R 99:100 /mnt/user/appdata/wealthfolio