Creating Wolfi Images with Dockerfiles
This tutorial demonstrates how to build a Wolfi Python image from scratch, using a Dockerfile workflow.
Wolfi is our Linux undistro designed from the ground up to support newer computing paradigms such as containers. Although Wolfi has a few similar design principles as Alpine (such as using apk), it is a different distribution that is focused on supply chain security. Unlike Alpine, Wolfi does not currently build its own Linux kernel, instead relying on the host environment (e.g. a container runtime) to provide one.
Without building packages from source, you are at the mercy of an intermediary provider (such as Debian or Alpine) for obtaining the software you need, and none of those intermediaries offer our SLA around zero CVEs. Each intermediary also joins your supply chain’s root of trust. We built Wolfi to achieve an unmatched CVE SLA where Chainguard is the only intermediary you need to trust. The following resources have more details around why and how we built Wolfi:
Yes, Wolfi is free and will always be.
No, it’s not possible to mix Alpine apks with Wolfi apks. If your image requires dependencies that are currently only available for Alpine, you might consider opening a new issue in the wolfi-os repository to suggest the new package addition, or use melange to build a custom apk for your image.
You can search for available packages using the apk search
command from within a Wolfi container, as explained in the Searching for Packages section of our Migrating to Chainguard Containers guide. You can also use our APK Explorer tool for a web-based search on the Wolfi repositories.
No. Wolfi is an un-distro, or distroless base to be used within the container / OCI ecosystem. Desktop distributions require additional software that is out of scope for Wolfi’s roadmap.
Wolfi was created and is currently maintained by Chainguard.
We intend for Wolfi to be a community-driven project, which means over time it will have multi-vendor governance and maintainers. For now we’re focused on building the project and community, and will revisit this in several months when a community has formed.
See SECURITY.md for information about reporting security incidents concerning and consuming security data about Wolfi.
Last updated: 2025-01-08 08:49