Overview of Chainguard OS
Learn about Chainguard OS, the security-focused operating system that powers Chainguard containers with continuous …
For the complete documentation index, see llms.txt.
This FAQ addresses common questions about Chainguard OS, the security-focused operating system that powers Chainguard’s Production container images and enterprise features.
Chainguard OS is a minimal, hardened Linux-based operating system designed for secure, containerized software delivery. Built in-house by Chainguard, it serves as the foundation for Chainguard’s container products and emphasizes continuous integration, immutable artifacts, and alignment with upstream software.
Wolfi is the open source core of Chainguard OS, and Chainguard builds and maintains both. Wolfi is the distribution behind Chainguard’s Free container images. Chainguard OS builds on Wolfi and adds packages and enterprise features, such as FIPS-validated packages and the EOL Grace Period. It’s the distribution behind Production container images and Chainguard’s other products.
The two work the same way. Both use the apk package format, and both are rolling releases: neither has major OS versions, and packages update continuously as upstream projects publish new releases. They differ in who can access them and what Chainguard commits to:
| Feature | Wolfi | Chainguard OS |
|---|---|---|
| Container images | Free containers, such as wolfi-base | Production containers, such as chainguard-base |
| Package repository | The public Wolfi repository, https://apk.cgr.dev/chainguard, which doesn’t require authentication | Your organization’s Private APK Repository, https://apk.cgr.dev/$ORGANIZATION_ID, which requires authentication |
| Vulnerability remediation SLAs | No | Yes |
| End-of-life (EOL) support | Updates stop when upstream support ends | Updates continue for an additional period under the EOL Grace Period |
| FIPS-validated packages | No | Yes |
| How scanners identify the OS | As Wolfi | As Chainguard, so scanners use Chainguard’s security feed |
Don’t mix packages from Wolfi and Chainguard OS in the same container image. Chainguard doesn’t support images that combine them.
To compare the wolfi-base and chainguard-base images in more detail, refer to Choosing a base container.
Chainguard OS is built around four core principles:
Each of these principles ensures that Chainguard OS can provide a more secure and efficient platform for software distribution.
Chainguard OS is designed specifically for more secure and containerized application delivery. Our approach differs from traditional distros in several key ways:
Last updated: 2026-11-06 14:00