QMS/be/README.md

Build instructions (local)

• Enter your database details in the src/main/resources/application.yml file (or use env vars)
• Through IntelliJ simply click on the run button
• Or through console
  • ./mvnw dependency:resolve
  • ./mvnw spring-boot:run

NOTE: requires Java 17 and MySQL 8

Docker deployment (single server)

From the be/ directory:

cp .env.example .env
# Edit .env if ports 8080 / 3306 are already in use on the server

docker compose up -d --build

Services and default host ports:

Service	Container	Host port (configurable)
Backend	qms-backend	BACKEND_HOST_PORT → 8080
MySQL	qms-mysql	MYSQL_HOST_PORT → 3306

API base URL on the server: http://<server-ip>:8080

Useful commands:

docker compose ps
docker compose logs -f backend
docker compose down          # stop containers (keeps DB volume)
docker compose down -v       # stop and delete DB/uploads volumes