cleanstart/kong repository overview

⁠Container Documentation for Kong Documentation

The CleanStart Kong 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/kong

Registry: cleanstart Registry

⁠Pull Latest Image

Download the container image from the registry

docker pull cleanstart/kong:latest

docker pull cleanstart/kong:latest-dev

⁠Basic Run

Run the container with basic configuration

docker run --name kong \
  -e KONG_DATABASE=off \
  -e KONG_PROXY_ACCESS_LOG=/dev/stdout \
  -e KONG_ADMIN_ACCESS_LOG=/dev/stdout \
  -e KONG_PROXY_ERROR_LOG=/dev/stderr \
  -e KONG_ADMIN_ERROR_LOG=/dev/stderr \
  -e KONG_ADMIN_LISTEN=0.0.0.0:8001 \
  -p 8000:8000 -p 8443:8443 -p 8001:8001 \
  cleanstart/kong:latest

⁠Production Deployment

Deploy with production security settings

docker run -d --name kong-prod \
  --security-opt=no-new-privileges \
  --restart unless-stopped \
  -e KONG_DATABASE=off \
  -e KONG_PROXY_ACCESS_LOG=/dev/stdout \
  -e KONG_ADMIN_ACCESS_LOG=/dev/stdout \
  -e KONG_PROXY_ERROR_LOG=/dev/stderr \
  -e KONG_ADMIN_ERROR_LOG=/dev/stderr \
  -e KONG_ADMIN_LISTEN=0.0.0.0:8001 \
  -p 8000:8000 -p 8443:8443 \
  cleanstart/kong:latest

Create kong.yml file

mkdir -p ~/kong-config
cat > ~/kong-config/kong.yml <<'EOF'
_format_version: "3.0"
services:
- name: example-service
  url: http://httpbin.org
  routes:
  - name: example-route
    paths:
    - /example
EOF

Volume Mount Mount local directory for persistent data

docker run --name kong-config \
  -e KONG_DATABASE=off \
  -e KONG_DECLARATIVE_CONFIG=/kong/declarative/kong.yml \
  -e KONG_ADMIN_LISTEN=0.0.0.0:8001 \
  -v ~/kong-config:/kong/declarative \
  -p 8010:8000 -p 8011:8001 \
  cleanstart/kong:latest

Port Forwarding Run with custom port mappings

docker run --name kong-ports \
  -e KONG_DATABASE=off \
  -e KONG_ADMIN_LISTEN=0.0.0.0:8001 \
  -p 9000:8000 -p 9001:8001 \
  cleanstart/kong: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.