A local-first, open-source investment tracker. The core app is free; data stays on your device. Wealthfolio Connect is an optional paid service that adds automatic broker sync (via SnapTrade) and end-to-end encrypted multi-device sync.

Which platforms is Wealthfolio on?

Desktop (macOS, Windows, Linux), iOS, and self-hosted web. Each platform runs its own local database. Android is on the roadmap.

Is the core app free?

Yes. The desktop and self-hosted core are free forever. Connect is an optional subscription for broker sync and device sync.

What's the fastest way to get started?

For each existing position, add a TRANSFER_IN activity with the External flag checked to seed the lot at your current quantity and cost basis. Add a single DEPOSIT for your cash balance. Switch to full BUY/SELL tracking going forward.

Where is my data stored?

Locally in an SQLite database. Windows: %APPDATA%\Wealthfolio. macOS: ~/Library/Application Support/com.teymz.wealthfolio/. Linux: ~/.local/share/com.teymz.wealthfolio/. iOS: app sandbox storage (iCloud-backed if enabled). Self-hosted: /app/data inside the container. With Connect, data is encrypted on-device before syncing.

How do I back up before a big change?

Settings → Exports → choose Full database (SQL) for a complete snapshot you can restore. CSV and JSON exports are also available for individual collections.

How do I move Wealthfolio to a new computer?

Copy the data directory from the old machine to the same location on the new one, or export the full database SQL and import it on the new machine.

Can I sync across devices?

Yes, with Wealthfolio Connect. Sync is end-to-end encrypted on-device — we cannot read your portfolio.

Does Wealthfolio track me or collect data?

No. The only external calls the app makes are to market-data providers (for prices) and the updater (to check for new versions). No analytics, no telemetry.

What does the CSV need to look like?

UTF-8, header row, ISO dates, decimal points (not commas), one activity per row. The mapping step aligns your broker columns to Wealthfolio fields.

Why is my import failing with "missing symbol" or "$ in price"?

Every row needs a symbol — use $CASH- for pure cash activities. Strip currency symbols and thousands separators from price/amount fields before import ($57.50 should be 57.50).

Can I import a cash-only or bank account?

Yes. Use the $CASH- symbol (e.g. $CASH-EUR) on DEPOSIT, WITHDRAWAL, INTEREST, FEE, and TAX rows. The importer treats those as pure cash activities — no security lookup needed.

Will re-importing the same file duplicate activities?

No. The importer detects duplicates by date, symbol, quantity, price, and amount, and skips them. The preview shows new vs. duplicate rows before you confirm.

Is there a per-broker recipe?

Yes — recipes for Schwab, Fidelity, Vanguard, IBKR, Robinhood, Trading 212, Wealthsimple, Questrade, BofA, and Guideline are documented in the CSV Import guide. Contributions for other brokers are welcome on GitHub.

How do I record a transfer between accounts?

Create a TRANSFER_OUT on the source account and a matching TRANSFER_IN on the destination. Cost basis is preserved on securities transfers. If both activities are dated the same day, give the OUT an earlier timestamp than the IN.

How do I transfer an asset out (e.g., crypto sent to a wallet)?

Use a TRANSFER_OUT with the External flag checked — Wealthfolio closes the lots via FIFO without realising a gain. For internal moves between Wealthfolio accounts, leave the External flag off and pick the destination account; cost basis is preserved.

How do I record dividend reinvestment (DRIP)?

Create a DIVIDEND activity with the DRIP subtype. Wealthfolio records the dividend income and the resulting share purchase in one step. The CSV importer auto-detects DRIP rows in most broker formats.

How do I record a stock split?

Add a SPLIT activity on the split date with the ratio (e.g. 4-for-1). Wealthfolio adjusts quantity and per-share cost. Don't double-apply: if your broker CSV already reflects post-split quantities and Yahoo shows adjusted prices, skip the SPLIT.

Can I track options, short positions, bonds, or RSUs?

Partial support today. Options: record BUY/SELL with the 100x multiplier auto-applied; Option Expiry adjustment subtype removes expired contracts. Short positions and complex options strategies are on the roadmap. Bonds: tracked as securities; coupon attribution is on the roadmap. RSUs: TRANSFER_IN with the External flag, recording the vest-date cost basis.

How do staking rewards work?

Use INTEREST with the Staking Reward subtype. Wealthfolio records both the interest income and the resulting token acquisition in one step.

How do I record withholding tax on dividends?

Two patterns. Gross + tax: record the DIVIDEND at the gross amount and a separate TAX activity for the withholding. Net: record the DIVIDEND at the net amount your broker deposited (loses gross/withholding breakdown but cash reconciles cleanly).

Are fees double-counted if I use both inline fees and FEE activities?

Yes, if you log the same fee twice. Pick one: include the commission as the fee field on the BUY/SELL, or create a separate FEE activity — not both.

Which ticker format does Wealthfolio use?

Symbols are provider-agnostic. Each asset stores a canonical ticker (e.g. RY, AAPL) plus an optional exchange MIC code (e.g. XTSE for Toronto). Wealthfolio's resolver translates to whatever each provider expects — Yahoo wants RY.TO, Börse Frankfurt wants XETR:RY, OpenFIGI wants an ISIN. You can type either the bare ticker or the Yahoo-suffix form when adding an asset.

The same ticker exists on two exchanges — how do I pick the right one?

Add the exchange to the symbol when creating the asset — Yahoo suffix (IWDA.AS) or MIC code in the exchange field. Edit the asset Exchange setting any time. For provider-specific symbols, add a per-provider override on the Market Data tab.

Which market data providers are supported?

Built-in: Yahoo Finance (default), Alpha Vantage, Finnhub, MarketData.app, OpenFIGI (bonds/ISIN), Börse Frankfurt, Metal Price API, US Treasury Calc, and user-defined Custom providers (JSON/HTML/table/CSV). Each asset has a preferred provider and optional per-provider symbol overrides.

My security isn't on Yahoo. What do I do?

Either try another built-in provider (Alpha Vantage, Finnhub, OpenFIGI for bonds, Börse Frankfurt for DE-listed) by setting the asset's preferred provider, or build a custom market data provider pointed at any JSON, HTML, table, or CSV source.

A provider expects a different symbol than the one I stored — fix?

Open the asset → Market Data tab → set a per-provider override. The override is used when querying that provider; the canonical symbol is untouched.

My custom security defaults to USD — can I change it?

Yes. Open the asset → Edit → set the Currency field. Wealthfolio also normalizes minor currency units like GBp pence to GBP automatically.

Why did prices stop updating?

Common causes: the provider returned bad or stale data (check the Health Center), the symbol delisted (switch to manual quotes), the provider is rate-limited or its circuit breaker tripped, or the provider expects a different symbol — add a per-provider override.

Will Wealthfolio keep fetching quotes for tickers I no longer hold?

No. Once an asset has zero quantity and no recent activities, Wealthfolio stops scheduling quote refreshes. Historical quotes are retained.

Why does my gain/loss look wrong in my base currency?

Wealthfolio uses the FX rate on the trade date to convert each activity into your base currency. When FX moves later, your unrealized gain/loss in base currency moves too, even if the security price didn't change.

Can I change an account's currency after creating it?

No, the account currency is set at creation. Workaround: create a new account in the correct currency and use TRANSFER_IN to move holdings over (cost basis preserved).

Can goals be in a non-base currency?

Goals are denominated in your base currency. Multi-currency goals are on the roadmap.

How are FX rates fetched, and can I override them?

Rates come from your configured market data provider. Override at Settings → Exchange Rates — Wealthfolio uses your manual rate instead of the fetched one from that date forward.

What does the percentage on my dashboard actually mean?

Per-account percentages show money-weighted return (MWR) — your timing matters. Total portfolio percentage shows time-weighted return (TWR) — strips out contributions/withdrawals for benchmark comparability. The two can disagree; that's not a bug.

Why did my return spike to a huge number?

Usually: tiny starting denominator (small initial balance makes the % return enormous), manually-quoted asset with a step change, or bad provider data (Yahoo occasionally returns spurious spikes — the Health Center flags them).

Why does my account show profit but a specific holding shows a loss?

The account % blends realized gains (sales + dividends + interest) with unrealized gains (market value vs. cost basis). A single holding can be down while realized income and other holdings carry the account into profit.

Cost basis: FIFO only? Why no LIFO or average cost?

FIFO today, intentionally. It's the most defensible default for tax reporting in most jurisdictions. LIFO and weighted-average cost are planned — additional cost-basis methods will be added in future versions.

Is "average cost" a moving average or FIFO?

Cost-basis accounting is FIFO. The average cost shown on a holding is just a display figure — total cost basis of your open lots divided by remaining shares — not a moving-average accounting method, and no running moving-average price is kept. When you sell, realized gains close the oldest lot first (FIFO), not at a moving-average price. In jurisdictions that tax on a moving average, such as Austria's gleitender Durchschnittspreis, Wealthfolio's realized gains will diverge from your tax calculation and need manual reconciliation. Moving-average/weighted-average cost (WAC) is planned — additional cost-basis methods will be added in future versions.

How do I archive an account?

Settings → Accounts → edit the account → toggle Active off. Archived accounts keep their data but are hidden from the dashboard.

TFSA / RRSP / 401(k) / IRA contribution tracking — how does it work?

Mark the account type, then Wealthfolio sums all DEPOSIT activities for the period and compares against the contribution limit you set.

Why don't TRANSFER_INs count toward contribution room?

By design — transfers between your own accounts aren't new contributions. For external rollovers that should count, use DEPOSIT instead.

Can I track real estate, vehicles, or other alternative assets?

Yes. Add the asset with kind Property, Vehicle, Collectible, Precious Metal, or Liability. The Purchase price field acts as cost basis; update value manually over time.

Can I have a virtual / combined account spanning brokers?

No first-class virtual account yet. Workarounds: build a custom fund-of-funds security you price manually, or use Account Groups in Settings to roll up performance across multiple real accounts.

Can I self-host? Do I still need Connect?

You can self-host for free. Connect is optional — only needed for automatic broker sync via SnapTrade or end-to-end encrypted device sync. Self-hosting plus manual imports needs nothing else.

"Permission denied" or "attempt to write a readonly database" after upgrading

In 3.4.0+, the Docker container runs as UID 1000 instead of root. If your existing data volume is root-owned, SQLite cannot write. Fix: stop the container, then `sudo chown -R 1000:1000 /path/to/your/wealthfolio/data` and start it again.

Why is my self-hosted instance hitting wealthfolio.app?

The release-check ping looking for updates. It carries no portfolio data. To disable, toggle off Settings → General → Check for updates automatically inside the app.

Custom providers can't reach my LAN or reverse proxy

Wealthfolio doesn't block private IP ranges for custom providers. If you can't reach the host, the issue is usually DNS, container networking, reverse-proxy ACLs, or TLS verification. Test the URL from the same shell or container Wealthfolio runs from.

Can mobile connect to my self-hosted instance?

Not natively, but the web interface works as a Progressive Web App. On iOS Safari, open your self-hosted URL and Add to Home Screen for app-like access. Native iOS connection to self-hosted is on the roadmap.

Which Docker image should I pull?

wealthfolio/wealthfolio on Docker Hub. Pin to a specific tag for production (e.g. wealthfolio/wealthfolio:3.4.0) — latest will follow new major versions.

Not available today. It's on the roadmap and is the most-reacted issue on GitHub (#592).

Wealthfolio FAQ

Docs

Wealthfolio FAQ

Answers to the questions we see most often about imports, transfers, FX, performance metrics, self-hosting, and more.

This FAQ is the front door. For deeper explanations, follow the links inside each answer to the concept docs and user guide.

Getting started

Data, privacy, and backup

CSV import

Activities, transfers, dividends, splits

Symbols & market data

Multi-currency & FX

Performance metrics

Accounts & contribution limits

Self-hosting & Connect

Addons & AI

Troubleshooting

API Reference Glossary

On This Page

Getting started
Data, privacy, and backup
CSV import
Activities, transfers, dividends, splits
Symbols & market data
Multi-currency & FX
Performance metrics
Accounts & contribution limits
Self-hosting & Connect
Addons & AI
Troubleshooting

Getting Started

Concepts

User Guide

Sync & AI

Self-Hosting

Addon Development

Reference

Connect

Getting Started

Concepts

User Guide

Sync & AI

Self-Hosting

Addon Development

Reference

Wealthfolio FAQ

Getting started

Data, privacy, and backup

CSV import

Activities, transfers, dividends, splits

Symbols & market data

Multi-currency & FX

Performance metrics

Accounts & contribution limits

Self-hosting & Connect

Addons & AI

Troubleshooting

Getting Started

Concepts

User Guide

Sync & AI

Self-Hosting

Addon Development

Reference

Connect

Wealthfolio FAQ

Getting started

What is Wealthfolio?

Which platforms is Wealthfolio on?

Is the core app free?

What's the fastest way to get started?

Data, privacy, and backup

Where is my data stored?

How do I back up before a big change?

How do I move Wealthfolio to a new computer?

Can I sync across devices?

Does Wealthfolio track me or collect data?

CSV import

What does the CSV need to look like?

Why is my import failing with "missing symbol" or "$ in price"?

Can I import a cash-only or bank account?

Will re-importing the same file duplicate activities?

Is there a per-broker recipe?

Activities, transfers, dividends, splits

How do I record a transfer between accounts?

How do I transfer an asset out (e.g., crypto sent to a wallet)?

How do I record dividend reinvestment (DRIP)?

How do I record a stock split?

Can I track options, short positions, bonds, or RSUs?

How do staking rewards work?

How do I record withholding tax on dividends?

Are fees double-counted if I use both inline fees and FEE activities?

Symbols & market data

Which ticker format does Wealthfolio use?

The same ticker exists on two exchanges — how do I pick the right one?

Which market data providers are supported?

My security isn't on Yahoo. What do I do?

A provider expects a different symbol than the one I stored — fix?

My custom security defaults to USD — can I change it?

Why did prices stop updating?

Will Wealthfolio keep fetching quotes for tickers I no longer hold?

Multi-currency & FX

Why does my gain/loss look wrong in my base currency?

Can I change an account's currency after creating it?

Can goals be in a non-base currency?

How are FX rates fetched, and can I override them?

Performance metrics

What does the percentage on my dashboard actually mean?

Why did my return spike to a huge number?

Why does my account show profit but a specific holding shows a loss?

Cost basis: FIFO only? Why no LIFO or average cost?

Is "average cost" a moving average or FIFO?

Accounts & contribution limits

How do I archive an account?

TFSA / RRSP / 401(k) / IRA contribution tracking — how does it work?

Why don't TRANSFER_INs count toward contribution room?

Can I track real estate, vehicles, or other alternative assets?

Can I have a virtual / combined account spanning brokers?

Self-hosting & Connect

Can I self-host? Do I still need Connect?

"Permission denied" or "attempt to write a readonly database" after upgrading

Why is my self-hosted instance hitting wealthfolio.app?

Custom providers can't reach my LAN or reverse proxy

Can mobile connect to my self-hosted instance?

Which Docker image should I pull?

OIDC / SSO support?

Addons & AI

Where can I find addons?

How do I install a downloaded addon?

How do I develop my own addon?

Is the AI assistant private? Does it need a paid API?

Troubleshooting

Windows SmartScreen or antivirus blocks the installer

AppImage shows a blank screen on Linux

The updater isn't working

Where are the application logs?

My portfolio isn't updating