Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 10 additions & 13 deletions profile/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
# Wolfi OS
Wolfi is the first community Linux (un)distribution declaratively built for creating a secure base layer for your containers!

Wolfi is a community Linux OS designed for the container and cloud-native era. Chainguard started the Wolfi project to enable building [Chainguard Images](https://github.com/chainguard-images), our collection of curated [distroless](https://blog.chainguard.dev/minimal-container-images-towards-a-more-secure-future/) images that meet the requirements of a secure software supply chain. This required a Linux distribution with components at the appropriate granularity and with support for [glibc](https://www.gnu.org/software/libc/).
Wolfi is a Linux OS designed for the container and cloud-native era. Chainguard started the Wolfi project to enable building [Chainguard Containers](https://www.chainguard.dev/containers), our collection of curated [distroless](https://blog.chainguard.dev/minimal-container-images-towards-a-more-secure-future/) images that meet the requirements of a secure software supply chain. This required a Linux distribution with components at the appropriate granularity and with support for [glibc](https://www.gnu.org/software/libc/).

Wolfi is a stripped-down distro designed for the cloud-native era. It doesn't have a kernel of its own, instead relying on the environment (such as the container runtime) to provide one. This separation of concerns in Wolfi means it is adaptable to a range of environments.

Expand All @@ -24,16 +24,13 @@ Wolfi, whose name was inspired by the [world's smallest octopus](https://en.wiki

## Wolfi Community

The [community repo](https://github.com/wolfi-dev/community) contains full details of our regular community calls, support forums and social media presence.

| Resource | Details, Links, etc. |
| Resource | Details |
| ----------- | ----------- |
| Notes | View our [notes](https://docs.google.com/document/d/1wBE3W81Xso6BDOU3-tWzfxGTP_X1HNsdufWbvyycaxE/edit#heading=h.zgngk9ekm1wf) from community meetings |
| YouTube | View our [playlist](https://youtube.com/playlist?list=PLLjvkjPNmuZkqtDoGuV-8SkZw6dwmHxF5) of recorded community meetings |
| Twitter / X | [`@wolfi_os`](https://twitter.com/wolfi_os) |
| Slack | `#apko` channel on [Kubernetes Slack](https://slack.kubernetes.io) |
| Forum | See [GitHub Discussions](https://github.com/orgs/wolfi-dev/discussions) |

The [community repo](https://github.com/wolfi-dev/community) contains full details of past community calls and resources.

## Get Started

To get you up and running with Wolfi, let's go over a quick demo where you can create an image from a Dockerfile.
Expand Down Expand Up @@ -87,22 +84,22 @@ For more guidance, you can check out a full tutorial on [Creating Wolfi Images w
Wolfi is a 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.

### Is Wolfi free to use?
Yes, Wolfi is free and will always be.
Yes, Wolfi is freely [available under the Apache License V2](https://github.com/wolfi-dev/os/blob/main/LICENSE) and will always be.

### Can I mix packages from Alpine repositories into a Wolfi-based image?
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](https://github.com/chainguard-dev/wolfi-os/) repository to suggest the new package addition, or use [melange](https://github.com/chainguard-dev/melange) to build a custom apk for your image.
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 using [melange](https://github.com/chainguard-dev/melange) to build a custom apk for your image.

### Can I use Wolfi on the Desktop?
No. Desktop distributions require additional software that is out of scope for Wolfi's roadmap.
No. Desktop distributions require additional software that is out of scope for Wolfi.

### Who maintains Wolfi?
Wolfi was created and is currently maintained by [Chainguard](https://chainguard.dev).
Wolfi was created and is currently maintained by [Chainguard](https://chainguard.dev) as the base of Chainguard OS.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this technically the case?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

From my understanding yes.. but I think it would be good if @johncslack could confirm with engineering. Otherwise we could also decide to leave this information out.


### What are the plans for long-term Wolfi governance?
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.
We intend for Wolfi to be the core foundation of Chainguard OS and available as open source project for use with minimal packages as used in our free Chainguard Containers.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My understanding is that they are different OSes but I have not been able to review many technical details.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the description is accurate but can you confirm ? @johncslack


### Where can I get security feeds for Wolfi?
See [SECURITY.md](/SECURITY.md) for information about reporting security incidents concerning and consuming security data about Wolfi.

### Where can I ask questions or learn more about using Wolfi?
We have a monthly community call on the 1st Wednesday of every month! Join the next meeting by following Wolfi’s public calendar, or submit your question to our GitHub Community discussions forum.
Find details in our [repositories](https://github.com/orgs/wolfi-dev/repositories), use our [community channels](#wolfi-community) and read our [documentation](https://edu.chainguard.dev/open-source/wolfi/overview/).