cleanstart/spring-boot repository overview

⁠Container Documentation for Spring-Boot Documentation

The CleanStart Spring-Boot image provides a production-ready, security-hardened container optimized for enterprise environments. Built on a minimal base OS with comprehensive security hardening, this image delivers reliable application execution with advanced security features.

📌 Base Foundation: Production-ready container from cleanstart.

Image Path: cleanstart/spring-boot

Registry: cleanstart Registry

cleanstart/spring-boot:latest is a Spring Boot CLI tool image (not a runnable REST API), designed for scaffolding Spring Boot projects via spring init and encoding passwords via spring encodepassword; it defaults to Gradle project generation and requires --type=gradle-project explicitly, as the --build=gradle shorthand is ambiguous in this version.

⁠Pull Latest Image

Download the container image from the registry

docker pull cleanstart/spring-boot:latest

docker pull cleanstart/spring-boot:latest-dev

⁠Basic Run

Run the container with basic configuration

docker run -it --name spring-boot cleanstart/spring-boot:latest

⁠Production Deployment

Deploy with production security settings

docker run -d --name spring-boot-prod \
  --security-opt=no-new-privileges \
  --user 1000:1000 \
  --restart unless-stopped \
  cleanstart/spring-boot:latest

Volume Mount Mount local directory for persistent data

docker run -v /app:/app cleanstart/spring-boot:latest

Port Forwarding Run with custom port mappings

docker run -p 8080:8080 cleanstart/spring-boot:latest

⁠Kubernetes Security Context

Recommended security context for Kubernetes deployments

securityContext:
  allowPrivilegeEscalation: false
  capabilities:
    drop:
    - ALL
  readOnlyRootFilesystem: true
  runAsUser: 1000
  runAsGroup: 1000

⁠Documentation Resources

Essential links and resources for further information

• Container Registry: https://www.cleanstart.com/⁠
• CleanStart Community Images: https://hub.docker.com/u/cleanstart⁠
• How-to-Run CleanStart images & sample projects: https://github.com/cleanstart-containers⁠
  • How to run sample projects using Dockerfile
  • How to deploy via Kubernetes YAML
  • How to migrate from public images to CleanStart images

Vulnerability Disclaimer

CleanStart offers Docker images that include third-party open-source libraries and packages maintained by independent contributors. While CleanStart maintains these images and applies industry-standard security practices, it cannot guarantee the security or integrity of upstream components beyond its control.

Users acknowledge and agree that open-source software may contain undiscovered vulnerabilities or introduce new risks through updates. CleanStart shall not be liable for security issues originating from third-party libraries, including but not limited to zero-day exploits, supply chain attacks, or contributor-introduced risks.

Security remains a shared responsibility: CleanStart provides updated images and guidance where possible, while users are responsible for evaluating deployments and implementing appropriate controls.