Open Source Wealth Management Software. Angular + NestJS + Prisma + Nx + TypeScript 🤍
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Go to file
Thomas Kaul 92e502e1c2
Release 1.103.0 (#628)
3 years ago
.storybook Feature/setup storybook (#332) 3 years ago
.vscode Release/1.71.0 (#458) 3 years ago
apps Bugfix/fix currency of value in position detail dialog (#627) 3 years ago
docker Feature/extend documentation for self hosting (#565) 3 years ago
libs Bugfix/support multiple accounts with the same name (#623) 3 years ago
prisma Feature/add google sheets as data source (#620) 3 years ago
test/import Feature/dividend (#547) 3 years ago
tools Initial commit 4 years ago
.editorconfig Initial commit 4 years ago
.env Reorder (#116) 4 years ago
.eslintrc.json disable naming convention eslint 3 years ago
.gitignore Feature/upgrade core dependencies (#490) 3 years ago
.prettierignore Add test data (#424) 3 years ago
.prettierrc Initial commit 4 years ago
.travis.yml Release/1.90.0 (#544) 3 years ago
.yarnrc Initial commit 4 years ago
CHANGELOG.md Release 1.103.0 (#628) 3 years ago
Dockerfile Support arm64 (#465) 3 years ago
LICENSE Add license (#8) 4 years ago
README.md Simplify instructions for development setup (#570) 3 years ago
angular.json Feature/upgrade core dependencies (#490) 3 years ago
decorate-angular-cli.js Initial commit 4 years ago
jest.config.js Feature/upgrade nx to version 12.8.0 (#331) 3 years ago
jest.preset.js Initial commit 4 years ago
nx.json Feature/upgrade core dependencies (#490) 3 years ago
package.json Release 1.103.0 (#628) 3 years ago
publish-docker-image.sh Feature/extend documentation for self hosting (#565) 3 years ago
replace.build.js Feature/set public stripe key dynamically (#216) 3 years ago
tsconfig.base.json Feature/setup storybook (#332) 3 years ago
yarn.lock Feature/add google sheets as data source (#620) 3 years ago

README.md

Ghostfolio Logo

Ghostfolio

Open Source Wealth Management Software made for Humans

Live Demo | Ghostfolio Premium | Blog | Slack | Twitter

Build Status License: AGPL v3

Ghostfolio is an open source wealth management software built with web technology. The application empowers busy people to keep track of their wealth like stocks, ETFs or cryptocurrencies and make solid, data-driven investment decisions.

Ghostfolio Premium

Our official Ghostfolio Premium cloud offering is the easiest way to get started. Due to the time it saves, this will be the best option for most people. The revenue is used for covering the hosting costs.

If you prefer to run Ghostfolio on your own infrastructure (self-hosting), please find further instructions in the section Run with Docker.

Why Ghostfolio?

Ghostfolio is for you if you are...

  • 💼 trading stocks, ETFs or cryptocurrencies on multiple platforms

  • 🏦 pursuing a buy & hold strategy

  • 🎯 interested in getting insights of your portfolio composition

  • 👻 valuing privacy and data ownership

  • 🧘 into minimalism

  • 🧺 caring about diversifying your financial resources

  • 🆓 interested in financial independence

  • 🙅 saying no to spreadsheets in 2021

  • 😎 still reading this list

Features

  • Create, update and delete transactions
  • Multi account management
  • Portfolio performance: Time-weighted rate of return (TWR) for Today, YTD, 1Y, 5Y, Max
  • Various charts
  • Static analysis to identify potential risks in your portfolio
  • Dark Mode
  • Zen Mode
  • Mobile-first design

Technology Stack

Ghostfolio is a modern web application written in TypeScript and organized as an Nx workspace.

Backend

The backend is based on NestJS using PostgreSQL as a database together with Prisma and Redis for caching.

Frontend

The frontend is built with Angular and uses Angular Material with utility classes from Bootstrap.

Run with Docker (self-hosting)

Prerequisites

a. Run environment

Run the following command to start the Docker images from Docker Hub:

docker-compose -f docker/docker-compose.yml up

Setup Database

Run the following command to setup the database once Ghostfolio is running:

docker-compose -f docker/docker-compose.yml exec ghostfolio yarn database:setup

b. Build and run environment

Run the following commands to build and start the Docker images:

docker-compose -f docker/docker-compose.build.yml build
docker-compose -f docker/docker-compose.build.yml up

Setup Database

Run the following command to setup the database once Ghostfolio is running:

docker-compose -f docker/docker-compose.build.yml exec ghostfolio yarn database:setup

Fetch Historical Data

Open http://localhost:3333 in your browser and accomplish these steps:

  1. Login as Admin with the following Security Token: ae76872ae8f3419c6d6f64bf51888ecbcc703927a342d815fafe486acdb938da07d0cf44fca211a0be74a423238f535362d390a41e81e633a9ce668a6e31cdf9
  2. Go to the Admin Control Panel and click Gather All Data to fetch historical data
  3. Click Sign out and check out the Live Demo

Finalization

  1. Create a new user via Get Started
  2. Assign the role ADMIN to this user (directly in the database)
  3. Delete the original Admin (directly in the database)

Migrate Database

With the following command you can keep your database schema in sync after a Ghostfolio version update:

docker-compose -f docker/docker-compose-build-local.yml exec ghostfolio yarn database:migrate

Development

Prerequisites

Setup

  1. Run yarn install
  2. Run docker-compose -f docker/docker-compose.dev.yml up -d to start PostgreSQL and Redis
  3. Run yarn database:setup to initialize the database schema and populate your database with (example) data
  4. Start server and client (see Development)
  5. Login as Admin with the following Security Token: ae76872ae8f3419c6d6f64bf51888ecbcc703927a342d815fafe486acdb938da07d0cf44fca211a0be74a423238f535362d390a41e81e633a9ce668a6e31cdf9
  6. Go to the Admin Control Panel and click Gather All Data to fetch historical data
  7. Click Sign out and check out the Live Demo

Start Server

  1. Debug: Run yarn watch:server and click "Launch Program" in Visual Studio Code
  2. Serve: Run yarn start:server

Start Client

Run yarn start:client

Start Storybook

Run yarn start:storybook

Testing

Run yarn test

Contributing

Ghostfolio is 100% free and open source. We encourage and support an active and healthy community that accepts contributions from the public - including you.

Not sure what to work on? We have got some ideas. Please join the Ghostfolio Slack channel, tweet to @ghostfolio_ or send an e-mail to hi@ghostfol.io. We would love to hear from you.

License

© 2021 Ghostfolio

Licensed under the AGPLv3 License.