How to install Money Balancer with docker and docker-compose

Have you ever been on a group trip and lost track of who paid for what and who owes money to whom? If so, money balancer (https://github.com/dorianim/money-balancer) is the perfect tool for you! It helps you to keep track of who paid for what and calculates your balance with all of your friends. A demo is available here but it may be reset at any time.

Requirements

• Docker
• Docker-compose

How to install?

If you haven't docker-compose, you can install it by run this command:

sudo curl -L "https://github.com/docker/compose/releases/download/v2.11.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/bin/docker-compose

You can find latest version of docker-compose at https://github.com/docker/compose/releases.

Add execute permission:

# Bash
sudo chmod +x /usr/bin/docker-compose

Step 1:

Create docker-compose.yml file:

version: "3"

services:
  money-balancer:
    image: ghcr.io/dorianim/money-balancer
    restart: unless-stopped
    ports:
      - 8000:8000
    volumes:
      - ./data:/data
    environment:
      - MONEYBALANCER_JWT_SECRET=some_super_secret_secret

Run docker-compose up -d to start container.

Step 2:

Now open your browser and type in http://localhost:8000.

How to use?

Step 1:

Click REGISTER. Follow the instructions in the image below.

Step 2:

Add your own information. Click Register. Follow the instructions in the image below. 

Step 3:

If you like, you can select the Dark Theme. Click + NEW GROUP. Follow the instructions in the image below.

Step 4:

Type Name the group then click CREATE. Follow the instructions in the image below.

Step 5:

Click on the group you have previously created at STEP 4. Follow the instructions in the image below.

Step 6:

Click + NEW TRANSACTION to add a new Transaction. Follow the instructions in the image below. 

Step 7:

Enter the transaction amount, who is using it, and a description for it. Click CREATE. Follow the instructions in the image below. 

Enjoy Money Balancer!