# Distroless

Distroless is a self-hosted infrastructure app. Distroless provides minimal base container images that contain only your application and its runtime dependencies, with no package manager, shell, or other programs. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/6629/distroless

## Description

Distroless provides minimal base container images that contain only your application and its runtime dependencies, with no package manager, shell, or other programs. They are suited to production container deployments where you want the smallest possible image size and the tightest attack surface.

## Platform availability

Available on 0 of 10 platforms.

## Health score

81/100 (Excellent), based on 4 of 5 factors.
- Maintained: 100 (last commit 1 day ago)
- Popular: 87 (23,286 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Security check: 94 (no serious findings, CI, tests, OpenSSF Scorecard 8.5/10)

## Links

- GitHub: https://github.com/GoogleContainerTools/distroless
- Docker Hub: https://hub.docker.com/r/istio/distroless

## Common questions

### How can I troubleshoot a Distroless container when it has no shell?

Standard Distroless images do not include a shell, so you cannot log in or run commands. Use the debug image and start it with sh to inspect files and troubleshoot.

### Why might a Distroless container fail to start because of the Dockerfile ENTRYPOINT?

Because Distroless has no shell, set ENTRYPOINT in the list form, such as ["myapp"]. The simple string form can cause the container to fail to start.

### How do I make a web app in a Distroless container reachable from a browser?

Map the web port with -p, for example -p 3000:3000 on docker run. Without the port mapping, the app can run but you cannot open it in a browser.

### Which Distroless image tags are currently updated?

The published and updated tags include latest, nonroot, debug, and debug-nonroot. You can reference architecture-specific images by adding a suffix such as latest-amd64, and other tags are considered deprecated.

### Can I use Distroless images without building them with Bazel?

Yes. The images are built using Bazel, but they can also be used through other Docker image build tooling.

---
Source: Our Local Host (https://ourlocalhost.com/app/6629/distroless), the self-hosted and open-source app directory.
