Skip to content

Installation

Get the projects

WARNING

Always use latest versions (release / tag) on both sides, only then it can be guaranteed that everything works fine.

Clone backend project

git clone git@github.com:Volmarg/personal-management-system.git

Clone frontend project

git clone git@github.com:Volmarg/personal-management-system-front.git

Alternatively You can just download the source code directly here:

https://github.com/Volmarg/personal-management-system/releases

Keep in mind that further guides assume that You did used git clone, and if You didn't then You need to solve potential upgrade problems on Your own.

Configure projects

If You plan to run backend and frontend on the same host / machine then there is nothing for You todo here.

However, if for whatever reason You plan to host projects on separate machines then You must adjust given configurations:

Fronted

dotenv
VITE_BACKEND_BASE_URL=

WARNING

If You decide to change frontend configuration, then You must rebuild the assets - meaning that You have to install all necessary dev dependencies, and configure Your environment for proper bundling.

Start the containers

In both case You need to execute these commands from the project root dir!

Frontend

sh
docker compose -f docker-compose-prod.yaml up -d

Backend

sh
docker compose -f docker-compose.yml up -d

Wait for ~1-3 min as the backend container needs to download, and boot everything up (first time takes long).