softfour/services repository overview

⁠Services Image

Docker image for running a Java service from /opt/services/services.jar, with SSH access for remote operations and log inspection.

⁠Defaults

• Java runtime: Eclipse Temurin JRE 25
• SSH user: services
• Home directory: /opt/services
• Main process: java -jar /opt/services/services.jar
• Time zone: UTC
• Locale: en_US.UTF-8
• Authentication: SSH public key only

The container generates an Ed25519 key pair at startup and automatically adds the generated public key to /opt/services/.ssh/authorized_keys.

If /opt/services/services.env exists, it is loaded before runtime configuration is applied.

⁠Docker Compose

Use a persistent volume mounted on /opt/services when the volume itself is the application home.

services:
  services:
    image: softfour/services:jre-25
    container_name: services
    hostname: services
    restart: unless-stopped
    tty: true
    environment:
      SERVICES_LOCALE_GEN: "en_US.UTF-8 UTF-8"
      SERVICES_LANG: "en_US.UTF-8"
      SERVICES_LANGUAGE: "en_US:en"
      SERVICES_LC_ALL: "en_US.UTF-8"
      SERVICES_TZ: "UTC"
    volumes:
      - services:/opt/services
    ports:
      - "8080:8080"

volumes:
  services:
    name: services

Mount the volume on /opt only when the volume already contains a nested services directory from older deployments.

⁠SSH Access

The generated private key is stored in:

/opt/services/.ssh/id_ed25519

Its public key is automatically added to:

/opt/services/.ssh/authorized_keys

For external clients, either retrieve the generated private key from the volume or add your own public key to authorized_keys.