cleanstart/k8s-sidecar repository overview

Verified K8S-SIDECAR Container Image

A hardened, minimal K8S-SIDECAR container image built from source with verifiable software provenance and an SBOM, designed for secure production deployments.

For additional versions including FIPS support, explore CleanStart Images — secure, hardened container images⁠

⁠Pull Latest Image

Download the container image from the registry

docker pull cleanstart/k8s-sidecar:latest

docker pull cleanstart/k8s-sidecar:latest-dev

Note: cleanstart/k8s-sidecar:latest is a Python-based Kubernetes sidecar that watches ConfigMaps and Secrets cluster-wide (via NAMESPACE=ALL) and syncs their data as files into a shared volume; it requires both the FOLDER_ANNOTATION env var and a matching annotation on each ConfigMap/Secret to specify the target directory, and with UNIQUE_FILENAMES=true writes files as namespace_._. to prevent cross-namespace collisions.

⁠Basic Run

Run the container with basic configuration

docker run -it --name k8s-sidecar cleanstart/k8s-sidecar:latest

⁠Production Deployment

Deploy with production security settings

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

Volume Mount Mount local directory for persistent data

docker run -v /app:/app cleanstart/k8s-sidecar:latest

Port Forwarding Run with custom port mappings

docker run -p 8080:8080 cleanstart/k8s-sidecar:latest

Why Use CleanStart Images⁠

• Verified — Built from source with verifiable software provenance
• Hardened — Minimal software footprint designed for secure deployment
• Transparent — SBOM available for visibility into image contents
• Production-ready — Built for modern container environments