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](https://ghostfol.io/pricing)** 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](#run-with-docker-self-hosting). ## 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](https://www.typescriptlang.org) and organized as an [Nx](https://nx.dev) workspace. ### Backend The backend is based on [NestJS](https://nestjs.com) using [PostgreSQL](https://www.postgresql.org) as a database together with [Prisma](https://www.prisma.io) and [Redis](https://redis.io) for caching. ### Frontend The frontend is built with [Angular](https://angular.io) and uses [Angular Material](https://material.angular.io) with utility classes from [Bootstrap](https://getbootstrap.com). ## Run with Docker (self-hosting) ### Prerequisites - [Docker](https://www.docker.com/products/docker-desktop) ### a. Run environment Run the following command to start the Docker images from [Docker Hub](https://hub.docker.com/r/ghostfolio/ghostfolio): ```bash docker-compose -f docker/docker-compose.yml up ``` #### Setup Database Run the following command to setup the database once Ghostfolio is running: ```bash 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: ```bash 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: ```bash 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` 1. Go to the _Admin Control Panel_ and click _Gather All Data_ to fetch historical data 1. Click _Sign out_ and check out the _Live Demo_ ### Finalization 1. Create a new user via _Get Started_ 1. Assign the role `ADMIN` to this user (directly in the database) 1. 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: ```bash docker-compose -f docker/docker-compose-build-local.yml exec ghostfolio yarn database:migrate ``` ## Development ### Prerequisites - [Docker](https://www.docker.com/products/docker-desktop) - [Node.js](https://nodejs.org/en/download) (version 14+) - [Yarn](https://yarnpkg.com/en/docs/install) ### Setup 1. Run `yarn install` 1. Run `cd docker` 1. Run `docker compose up -d` to start [PostgreSQL](https://www.postgresql.org) and [Redis](https://redis.io) 1. Run `cd -` to go back to the project root directory 1. Run `yarn database:setup` to initialize the database schema and populate your database with (example) data 1. Start server and client (see [_Development_](#Development)) 1. Login as _Admin_ with the following _Security Token_: `ae76872ae8f3419c6d6f64bf51888ecbcc703927a342d815fafe486acdb938da07d0cf44fca211a0be74a423238f535362d390a41e81e633a9ce668a6e31cdf9` 1. Go to the _Admin Control Panel_ and click _Gather All Data_ to fetch historical data 1. 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](https://join.slack.com/t/ghostfolio/shared_invite/zt-vsaan64h-F_I0fEo5M0P88lP9ibCxFg), tweet to [@ghostfolio\_](https://twitter.com/ghostfolio_) or send an e-mail to hi@ghostfol.io. We would love to hear from you. ## License ยฉ 2021 [Ghostfolio](https://ghostfol.io) Licensed under the [AGPLv3 License](https://www.gnu.org/licenses/agpl-3.0.html).