implementing-container-image-minimal-base-with-distroless

Reduce container attack surface by building application images on Google distroless base images that contain only the application runtime with no shell, package manager, or unnecessary OS utilities.

Jump to install

Repository: xalgord/xalgorix
Last source activity: June 6, 2026 at 16:41
Detected SKILL.md language: English
Stars: 813
Forks: 146

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/xalgord/xalgorix --skill implementing-container-image-minimal-base-with-distroless

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

exploiting-http-request-smuggling

Detecting and exploiting HTTP request smuggling vulnerabilities caused by Content-Length and Transfer-Encoding parsing discrepancies between front-end and back-end servers.

2026-07-20

exploiting-oauth-misconfiguration

Identifying and exploiting OAuth 2.0 and OpenID Connect misconfigurations including redirect URI manipulation, token leakage, and authorization code theft during security assessments.

2026-07-20

exploiting-subdomain-takeover-vulnerabilities

Identifying and exploiting dangling DNS records pointing to unclaimed cloud services, enabling subdomain takeover for phishing, cookie stealing, and authentication bypass during authorized penetration tests.

2026-06-19

View all from this repository

Implementing Container Image Minimal Base with Distroless

Overview

Google distroless images contain only your application and its runtime dependencies, without package managers, shells, or other programs found in standard Linux distributions. By eliminating unnecessary OS components, distroless images achieve up to 95% reduction in attack surface compared to traditional base images like ubuntu or debian. Major projects including Kubernetes itself, Knative, and Tekton use distroless images in production. As of 2025, Docker also offers Hardened Images (DHI) as an open-source alternative for minimal container bases.

When to Use

When deploying or configuring implementing container image minimal base with distroless capabilities in your environment

When establishing security controls aligned to compliance requirements

When building or improving security architecture for this domain

When conducting security assessments that require this implementation

Common Misconfigurations & Verification

Distroless image still runs as root: the plain gcr.io/distroless/static-debian12 tag defaults to UID 0; only the :nonroot tag (UID 65534) drops root, and even then an explicit USER nonroot:nonroot is needed if you override the entrypoint. Verify: docker run --rm <img> id should not report uid=0.

No readOnlyRootFilesystem at runtime: distroless shrinks the image but a writable rootfs still lets an attacker drop files - pair it with securityContext.readOnlyRootFilesystem: true and allowPrivilegeEscalation: false.

Setuid binaries copied in: COPY --from=builder can pull in setuid helpers from the build stage. Verify with dive <img> or docker run --rm <img> + a find for mode 4000 in the build stage.

Wrong base for linkage: a CGO/dynamically linked binary on static-debian12 fails at runtime ("no such file"); use base- or cc-debian12. A glibc binary needs base, not static.

Debug variant in production: :debug ships a busybox shell at /busybox/sh, reintroducing exec - confirm prod manifests pin the non-debug, :nonroot tag by digest.