ismailmasseran
0420194541
Co-authored-by: ISMAIL MASSERAN <topaz@Mac.dlinkrouter.local> Co-authored-by: ISMAIL MASSERAN <topaz@ISMAILs-Macbook.local> Reviewed-on: #4
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