softfour/batches repository overview

⁠Batches Image

Docker image for running Java batch applications with an SSH access layer for remote operations and log inspection.

⁠Defaults

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

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

⁠Docker Compose

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

services:
  batches:
    image: softfour/batches:jre-25
    container_name: batches
    hostname: batches
    restart: unless-stopped
    tty: true
    environment:
      BATCHES_LOCALE_GEN: "en_US.UTF-8 UTF-8"
      BATCHES_LANG: "en_US.UTF-8"
      BATCHES_LANGUAGE: "en_US:en"
      BATCHES_LC_ALL: "en_US.UTF-8"
      BATCHES_TZ: "UTC"
    volumes:
      - batches:/opt/batches

volumes:
  batches:
    name: batches

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

⁠SSH Access

The generated private key is stored in:

/opt/batches/.ssh/id_ed25519

Its public key is automatically added to:

/opt/batches/.ssh/authorized_keys

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