Java + Spring + PostgreSQL

Spring Boot is the de facto standard for building server-side Java applications. It auto-configures what it detects on the classpath, packages the application with its own embedded server, and starts with a single command.

This Stack combines it with PostgreSQL.

Services included

In addition to your application, the Stack brings up PostgreSQL, an nginx that receives traffic on port 80, an automatic backups service, and the web file manager.

Project structure

text

.
├── app
│   ├── src
│   │   └── ...
│   └── pom.xml
├── backup
│   └── backup-runner.sh
├── nginx
│   └── default.conf
├── .env.example
├── app.Dockerfile
└── compose.yaml

Getting started

Install the Stack and bring it up:

bash

docker-deploy-stack --stack java/spring-postgres
cd /root/stack/java/spring-postgres
docker compose up -d

Then replace the example application with yours, from Git, via SFTP or from the web file manager, following how-do-i-deploy-an-application-on-a-stack.md. Your code goes in the app/ folder.

Each time you update the code, apply the changes:

bash

docker compose up -d --build

Configuration

Editable values are in the Stack’s .env file:

Variable	Default	What it’s for
`APP_PORT`	`80`	Public port of the Stack.
`APP_ENV`	`development`	Application environment.
`DB_NAME`	`db`	Database name.
`BACKUP_ENABLED`	`1`	Automatic backups: `1` enabled, `0` disabled.
`BACKUP_INTERVAL_SECONDS`	`86400`	How many seconds between backups.
`BACKUP_RETENTION_DAYS`	`7`	How many days backups are retained.
`JAVA_VERSION`	`21`	Version of the corresponding image.
`MAVEN_VERSION`	`3.9.6`	Version of the corresponding image.
`POSTGRES_VERSION`	`17`	Version of the corresponding image.

After changing it, apply the changes with docker compose up -d.

Useful commands

bash

docker compose ps          # see running containers
docker compose logs -f     # view live logs
docker compose restart     # restart the services
docker compose down        # stop and remove the containers