Ghostfolio logo

Ghostfolio

  •  0 ratings
In category: Money & Budgeting & Management

About Ghostfolio

Wealth management software to keep track of stocks, ETFs and cryptocurrencies.

  •   779  
  •   0  
  •   0  
  •   0  
Github stats:
  •  Commits: 1,481  
  •   920  
  •   117  
  •  Latest commit: Feb 14, 2023  

Deploy this app to Linode with a free $100 credit!

Languages/Platforms/Technologies:
Lincenses:

More about Ghostfolio

[Ghostfolio logo](https://ghostfol.io) # Ghostfolio **Open Source Wealth Management Software** [**Ghostfol.io**](https://ghostfol.io) | [**Live Demo**](https://ghostfol.io/en/demo) | [**Ghostfolio Premium**](https://ghostfol.io/en/pricing) | [**FAQ**](https://ghostfol.io/en/faq) | [**Blog**](https://ghostfol.io/en/blog) | [**Slack**](https://join.slack.com/t/ghostfolio/shared_invite/zt-vsaan64h-F_I0fEo5M0P88lP9ibCxFg) | [**Twitter**](https://twitter.com/ghostfolio_) [![Shield: Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-Support-yellow?logo=buymeacoffee)](https://www.buymeacoffee.com/ghostfolio) [![Shield: Contributions Welcome](https://img.shields.io/badge/Contributions-Welcome-orange.svg)](#contributing) [![Shield: License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)

Ghostfolio is an open source wealth management software built with web technology. The application empowers busy people to keep track of stocks, ETFs or cryptocurrencies and make solid, data-driven investment decisions. The software is designed for personal use in continuous operation.

[Preview image of the Ghostfolio video trailer](https://www.youtube.com/watch?v=yY6ObSQVJZk)

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, please find further instructions in the Self-hosting section.

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
  • ๐Ÿ˜Ž still reading this list

Features

  • โœ… Create, update and delete transactions
  • โœ… Multi account management
  • โœ… Portfolio performance for Today, YTD, 1Y, 5Y, Max
  • โœ… Various charts
  • โœ… Static analysis to identify potential risks in your portfolio
  • โœ… Import and export transactions
  • โœ… Dark Mode
  • โœ… Zen Mode
  • โœ… Progressive Web App (PWA) with a mobile-first design
Image of a phone showing the Ghostfolio app open

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.

Self-hosting

We provide official container images hosted on Docker Hub for linux/amd64 and linux/arm64.

[Buy me a coffee button](https://www.buymeacoffee.com/ghostfolio)

Supported Environment Variables

Name Default Value Description
ACCESS_TOKEN_SALT A random string used as salt for access tokens
BASE_CURRENCY USD The base currency of the Ghostfolio application.
AUD | CAD | CNY | EUR | GBP | JPY | RUB | USD
Caution: Only set if you intend to track cryptocurrencies in a non-USD currency. This cannot be changed later!
DATABASE_URL The database connection URL, e.g. postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@localhost:5432/${POSTGRES_DB}?sslmode=prefer
HOST 0.0.0.0 The host where the Ghostfolio application will run on
JWT_SECRET_KEY A random string used for JSON Web Tokens (JWT)
PORT 3333 The port where the Ghostfolio application will run on
POSTGRES_DB The name of the PostgreSQL database
POSTGRES_PASSWORD The password of the PostgreSQL database
POSTGRES_USER The user of the PostgreSQL database
REDIS_HOST The host where Redis is running
REDIS_PASSWORD The password of Redis
REDIS_PORT The port where Redis is running

Run with Docker Compose

Prerequisites

  • Basic knowledge of Docker
  • Installation of Docker
  • Local copy of this Git repository (clone)

a. Run environment

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

docker-compose --env-file ./.env -f docker/docker-compose.yml up -d

b. Build and run environment

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

docker-compose --env-file ./.env -f docker/docker-compose.build.yml build
docker-compose --env-file ./.env -f docker/docker-compose.build.yml up -d

Fetch Historical Data

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

  1. Create a new user via Get Started (this first user will get the role ADMIN)
  2. Go to the Market Data tab in the Admin Control Panel and click Gather All Data to fetch historical data
  3. Click Sign out and check out the Live Demo

Upgrade Version

  1. Increase the version of the ghostfolio/ghostfolio Docker image in docker/docker-compose.yml
  2. Run the following command to start the new Docker image: docker-compose --env-file ./.env -f docker/docker-compose.yml up -d
    At each start, the container will automatically apply the database schema migrations if needed.

Run with Unraid (Community)

Please follow the instructions of the Ghostfolio Unraid Community App.

Development

Prerequisites

Setup

  1. Run yarn install
  2. Run yarn build:dev to build the source code including the assets
  3. Run docker-compose --env-file ./.env -f docker/docker-compose.dev.yml up -d to start PostgreSQL and Redis
  4. Run yarn database:setup to initialize the database schema and populate your database with (example) data
  5. Start the server and the client (see Development)
  6. Create a new user via Get Started (this first user will get the role ADMIN)
  7. Go to the Market Data tab in the Admin Control Panel and click Gather All Data to fetch historical data
  8. Click Sign out and check out the Live Demo

Start Server

Debug

Run yarn watch:server and click Launch Program in Visual Studio Code

Serve

Run yarn start:server

Start Client

Run yarn start:client and open http://localhost:4200/en in your browser

Start Storybook

Run yarn start:storybook

Migrate Database

With the following command you can keep your database schema in sync:

yarn database:push

Testing

Run yarn test

Public API

Authorization: Bearer Token

Set the header for each request as follows:

"Authorization": "Bearer eyJh..."

You can get the Bearer Token via GET http://localhost:3333/api/v1/auth/anonymous/<INSERT_SECURITY_TOKEN_OF_ACCOUNT> or curl -s http://localhost:3333/api/v1/auth/anonymous/<INSERT_SECURITY_TOKEN_OF_ACCOUNT>.

Import Activities

Request

POST http://localhost:3333/api/v1/import

Body

{
  "activities": [
    {
      "currency": "USD",
      "dataSource": "YAHOO",
      "date": "2021-09-15T00:00:00.000Z",
      "fee": 19,
      "quantity": 5,
      "symbol": "MSFT",
      "type": "BUY",
      "unitPrice": 298.58
    }
  ]
}
Field Type Description
accountId string (optional) Id of the account
currency string CHF | EUR | USD etc.
dataSource string MANUAL (for type ITEM) | YAHOO
date string Date in the format ISO-8601
fee number Fee of the activity
quantity number Quantity of the activity
symbol string Symbol of the activity (suitable for dataSource)
type string BUY | DIVIDEND | ITEM | SELL
unitPrice number Price per unit of the activity

Response

Success

201 Created

Error

400 Bad Request

{
  "error": "Bad Request",
  "message": [
    "activities.1 is a duplicate activity"
  ]
}

Community Projects

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 or tweet to @ghostfolio_. We would love to hear from you.

If you like to support this project, get Ghostfolio Premium or Buy me a coffee.

License

ยฉ 2023 Ghostfolio

Licensed under the AGPLv3 License.

Comments (0)

Please login to join the discussion on this project.

Ghostfolio Reviews (0)

Overall Rating

None

based on 0 ratings

Please login to review this project.

No reviews for this project yet.

↑ back to top

Linux VPS from $11/yr.
RackNerd VPS for $11.38/mo

Popular Projects

FluxBB

in Social Networks and Forums
 29k    0    0    0  

Nextcloud

in File Transfer & Synchronization
 17k    1    1    0  

Libreddit

in Social Networks and Forums
 5k    0    1    0  

CasaOS

in Self-hosting Solutions
 4k    0    0    0  

Audiobookshelf

in Audio Streaming
 3k    0    1    0  

Mediagoblin

in Photo and Video Galleries
 3k    0    0    0  

Dashboard

in Personal Dashboards
 2k    0    0    0  

Most Discussed

Nextcloud

in File Transfer & Synchronization
 17k    1    1    0  

Tube Archivist

in Automation
 2k    0    1    0  

OneDev

in Project Management
 1k    0    0    0  

iodine

in Proxy
 1k    0    0    0  

Alf.io

in Booking and Scheduling
 1k    0    0    0  

sysPass

in Password Managers
 741    0    0    0  

Misskey

in Social Networks and Forums
 2k    0    0    0  
pCloud Lifetime

Top Rated Projects

Gitea

 1 rating
in Project Management

Bagisto

 1 rating
in E-commerce

LinkAce

 1 rating
in Bookmarks and Link Sharing

Pydio

 1 rating
in File Transfer & Synchronization

Audiobookshelf

 1 rating
in Audio Streaming

Nextcloud

 1 rating
in File Transfer & Synchronization

Seafile

 1 rating
in File Transfer & Synchronization

Categories

You May Also Be Interested In

DePay logo
DePay cover

DePay

Accept Web3 Payments directly into your wallet. Peer-to-peeโ€ฆ

BTCPay Server logo
BTCPay Server cover

BTCPay Server

A self-hosted Bitcoin and other cryptocurrencies payment prโ€ฆ

Fava logo
Fava cover

Fava

Fava is the web frontend of Beancount, a text based double-โ€ฆ