k8sgpt

Utils

Updated on July 27

K8sGPT Overview

Secure your stack with a hardened K8sGPT image freshly-built by Minimus. Minimus images always include the most up-to-date package version for all packages and dependencies contained in the image.

K8sGPT is an AI-powered Kubernetes diagnostic tool that scans clusters to detect, triage, and explain issues in plain English. It runs built-in analyzers against core resources such as pods, deployments, services, and events, then optionally enriches the findings with natural-language explanations from a configurable AI backend like OpenAI, Azure OpenAI, Amazon Bedrock, Google Gemini, or a local model. K8sGPT also supports custom analyzers, remote result caching, and a serve mode with REST, gRPC, and MCP interfaces for integrating with AI assistants.

Try It Out

For a quick test, print the help menu:

docker run --rm reg.mini.dev/k8sgpt --help

Analyze a Kubernetes cluster

If you have a running Kubernetes cluster with an accessible kubeconfig, you can mount your kubeconfig to scan a live cluster using the built-in analyzers:

docker run --rm \
  -e KUBECONFIG=/home/nonroot/.kube/config \
  -v $HOME/.kube/config:/home/nonroot/.kube/config:ro \
  reg.mini.dev/k8sgpt analyze

Get AI-powered explanations

If you have an API key for a supported AI backend (such as OpenAI) you can enable AI-generated explanations.

Configure an AI backend:

docker run --rm \
  -v $HOME/.k8sgpt:/home/nonroot/.k8sgpt \
  reg.mini.dev/k8sgpt auth add --backend openai --model gpt-4o-mini --password <your-openai-api-key>

Run the analysis with --explain to enrich each finding with a natural-language explanation. You can mount a local directory so the backend configuration persists between runs

docker run --rm \
  -e KUBECONFIG=/home/nonroot/.kube/config \
  -v $HOME/.kube/config:/home/nonroot/.kube/config:ro \
  -v $HOME/.k8sgpt:/home/nonroot/.k8sgpt \
  reg.mini.dev/k8sgpt analyze --explain

Technical Considerations

The K8sGPT image provided by Minimus is a slim, security-hardened alternative to the public image from Docker Hub. The images are largely interchangeable, with a few differences as noted below.

K8sGPT built by Minimus:

Runs as non-root by default as user 65532, matching the public image.
Drill down on the version specification tab to see the default user, listening ports, entrypoint, volumes, environment variables, etc.

The Payoff

A hardened, minimal image that will remain more secure for the long run and accrue vulnerabilities at a slower rate.

See the risk reduction dashboard for a detailed CVE comparison over the past 30 days.
Review the compliance report to see the default hardening and security configurations for the image.

Terms & Info

Trademark

This catalog is published by Minimus. All product names, logos, and marks, other than those belonging to Minimus, shown are owned by their respective rights holders and appear here only to identify the open source software each image contains. Minimus claims no ownership of those marks and implies no affiliation with, endorsement by, certification by, or sponsorship by any rights holder.

Disclaimer

Images are provided "as-is" without warranty of any kind. "Hardened" refers to the security configuration applied at the time of build and does not constitute a guarantee of ongoing security or absence of vulnerabilities. The free tier is provided without support, SLA, or guaranteed patching timelines. Security updates may be applied to paid subscriptions before or instead of free tier images. By pulling or using any image you agree to our Terms of Use.