# Richy

> Self-hosted, open-source portfolio manager for stocks, ETFs, indexes and crypto, with a transactional ledger, performance charts and market news.

- **Category:** [Personal Finance](https://selfhost.directory/personal-finance)
- **Licence:** mit
- **Source model:** Open source
- **Latest version:** 1.1.0
- **Author:** imn1
- **Platforms:** Docker Compose
- **Ports:** 8000 (Gunicorn serves the Django app inside the richy container)
- **Requires:** Redis, PostgreSQL
- **Tags:** Charts, Portfolio, Django, Cryptocurrency, Celery, News aggregation, Staking, Stocks, Investing, Etf

## Docker images

- [`n1cz/richy`](https://hub.docker.com/r/n1cz/richy)

## What is Richy?

A Django-based investment tracker for individuals who would rather keep their holdings and market context in one owned service than in spreadsheets. It follows shares, ETFs, market indexes and coins, records every trade in a ledger, and derives performance, drawdown and asset-allocation views from that history. Dividends, analyst ratings and staking positions are stored too, and an RSS-driven news section keeps market headlines attached to the items you hold. Computation is backend-heavy: Celery queues plus a periodic scheduler fetch and process data against PostgreSQL and Redis, while pages stay server-rendered with only a few Vue chart widgets. To run it yourself you copy the shipped environment, compose and nginx templates, pull the published n1cz/richy image and bring the stack up, then load the built-in admin fixture; Django Admin under /admin covers users, exchanges, items and scheduled jobs. Market data comes from scraped sources, so the maintainer warns those feeds can break and fixes usually land under the nightly image tag; the app is explicitly not a trading bot, an advice engine or an AI market predictor.

## Should you self-host Richy?

Richy scores **52/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#25 of 63** in [Personal Finance](https://selfhost.directory/personal-finance).

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is mit-licensed.

Its closest alternative on selfhost.directory is [Sure](https://selfhost.directory/project/sure) (85/100, 15 888 stars). It scores higher overall, so compare the two before you pick. [See Richy vs Sure side by side.](https://selfhost.directory/compare/richy-vs-sure)

## Features

- Admin Interface
- Analyst ratings
- Asset allocation view
- Dividend tracking
- Multi-asset support
- Multi-user support
- News aggregation
- Performance charts
- Portfolio Tracking
- Scheduled background tasks
- Staking tracking
- Transaction ledger

## How to install Richy

### Install Richy with Docker Compose

Environment variables:

```
BASE_URL, DOMAIN, TZ
```

```
$ cp .env.skel .env
$ cp compose.yaml.skel compose.yaml
$ cp nginx.conf.skel nginx.conf
```

```
$ docker pull n1cz/richy:nightly
```

```
$ docker compose up -d
```

```
$ docker exec -it richy ./manage.py loaddata users
```

Note: Production stack runs richy (gunicorn), celery beat and three worker queues, plus redis, Postgres and nginx; the shipped nginx template is SSL/Let's Encrypt ready but you must supply your own certificates.

## Richy alternatives

- [assets](https://selfhost.directory/project/assets): Assets is a self-hosted portfolio tracker consolidating investments across brokers with Yahoo Finance data, multi-user support, CSV import, and a REST API. (compare: https://selfhost.directory/compare/assets-vs-richy)
- [Wealthfolio](https://selfhost.directory/project/wealthfolio): Open-source, local-first investment tracker for holdings, net worth and spending, with free desktop, mobile and self-hosted Docker editions. (compare: https://selfhost.directory/compare/richy-vs-wealthfolio)
- [WYGIWYH](https://selfhost.directory/project/wygiwyh): Open-source, self-hosted personal finance tracker with multi-currency accounts, transaction rules, a built-in DCA tracker and an automation REST API. (compare: https://selfhost.directory/compare/richy-vs-wygiwyh)
- [Rotki](https://selfhost.directory/project/rotki): Self-hosted, open-source crypto portfolio tracker that decodes on-chain and exchange history into readable events and local profit/loss tax reports. (compare: https://selfhost.directory/compare/richy-vs-rotki)
- [Ghostfolio](https://selfhost.directory/project/ghostfolio): Self-hosted, open-source dashboard for personal wealth: track stocks, ETFs, crypto and multiple accounts with portfolio performance and analysis. (compare: https://selfhost.directory/compare/ghostfolio-vs-richy)
- [investbrain](https://selfhost.directory/project/investbrain): Self-hosted investment tracker with AI chat on your holdings, multi-provider market data with fallback, and Docker Compose deployment. (compare: https://selfhost.directory/compare/investbrain-vs-richy)
- [bliss](https://selfhost.directory/project/bliss): Bliss is a self-hosted, open-source personal finance platform for multi-currency accounts, investments, and expenses with AI classification and portfolio tracking. (compare: https://selfhost.directory/compare/bliss-vs-richy)
- [MoneyMatter](https://selfhost.directory/project/moneymatter): MoneyMatter is a self-hosted, open-source personal finance app for tracking accounts, budgets, investments, and net worth with bank sync and AI. (compare: https://selfhost.directory/compare/moneymatter-vs-richy)

## More in Personal Finance

- [Rotki](https://selfhost.directory/project/rotki): Self-hosted, open-source crypto portfolio tracker that decodes on-chain and exchange history into readable events and local profit/loss tax reports.
- [Securo](https://selfhost.directory/project/securo): Self-hosted, open-source personal finance app: bank sync, transaction rules, budgets, asset tracking and net-worth reports, plus OIDC, passkeys and AI agents.
- [SparkyBudget](https://selfhost.directory/project/sparkybudget): SparkyBudget is a self-hosted personal finance app for tracking accounts, managing budgets, and analyzing spending with a dark UI and SimpleFin sync.
- [spliit](https://selfhost.directory/project/spliit): Self-hosted, open-source expense splitting app where groups track shared spending with uneven splits, balances, reimbursements and optional AI receipt scanning.
- [splitpro](https://selfhost.directory/project/splitpro): SplitPro is a self-hosted, open-source expense tracker that replaces Splitwise with unlimited expenses, groups, recurring bills, receipt attachments, and PWA support.
- [subscription-manager](https://selfhost.directory/project/subscription-manager): Self-hosted web app to track subscriptions, view payment calendars, calculate totals, and get notified via NTFY or Gotify. Open-source with Docker deployment.
- [SubTracker](https://selfhost.directory/project/subtracker): SubTracker is an open-source, self-hosted subscription manager to track renewals, budgets, and spending across currencies with AI capture and Wallos migration.
- [Sure](https://selfhost.directory/project/sure): Self-hosted open-source personal finance app forked from Maybe Finance: track bank, stock and crypto accounts in any currency, budget, and query an AI assistant.
- [syllogic](https://selfhost.directory/project/syllogic): Syllogic is an open-source, self-hosted personal finance dashboard tracking balances, spending, and recurring charges with optional AI categorization.
- [Thrifty](https://selfhost.directory/project/thrifty): Thrifty is a self-hosted, open-source personal finance web app for tracking monthly income and expenses with multi-user support.
- [TrackMyRupee](https://selfhost.directory/project/trackmyrupee): Self-hosted, open-source personal finance tracker for Indian professionals with manual entry, net worth tracking, loan management, and multi-currency support.
- [VoucherVault](https://selfhost.directory/project/vouchervault): Self-hosted Django app to manage digital coupons, vouchers, loyalty cards and gift cards with PWA offline access, expiry alerts, OIDC login, and stats API.

## Links

- [Homepage](https://gitlab.com/imn1/richy)
- [Richy documentation](https://richy.readthedocs.io/)

---
Source: https://selfhost.directory/project/richy