Wolfi

This is the main package repository for the Wolfi project.

Named after the smallest octopus, Wolfi is a lightweight GNU software distribution which is designed around minimalism, making it well-suited for containerized environments built with apko.

It is built using melange, and is sponsored by Chainguard, which uses it to provide lightweight GNU/Linux runtime images.

The Wolfi APK package repository is located at https://packages.wolfi.dev/os and the signing public key is at https://packages.wolfi.dev/os/wolfi-signing.rsa.pub.

Wolfi is not intended to be a general purpose desktop operating system. Our priority is to provide packages that enable containerized and embedded system workflows. Packages must use an open source license, ideally FSF or OSI approved licenses.

Wolfi aims to keep its package set as up-to-date with security patches as possible, and uses latest releases of packages by default. Package and version in Wolfi must have an actively maintained upstream project.

Find more information in our organization overview and FAQ.

This repository is a read-only public clone, synced from internal Chainguard repositories. Pull requests opened here cannot be merged directly. See CONTRIBUTING.md for details.

Getting Started

A full guide is available on the org page, but the quickest way to try out Wolfi is with the wolfi-base image:

docker run -it cgr.dev/chainguard/wolfi-base
52aace776b20:/# uname -a
Linux 52aace776b20 5.15.49-linuxkit-pr #1 SMP PREEMPT Thu May 25 07:27:39 UTC 2023 aarch64 Linux
52aace776b20:/# cat /etc/os-release
ID=wolfi
NAME="Wolfi"
PRETTY_NAME="Wolfi"
VERSION_ID="20230201"
HOME_URL="https://wolfi.dev"

Mixing packages with other distributions

Mixing packages with other distributions is not supported and can create security problems. Although both Wolfi and Alpine use the apk package manager, packages are not compatible with each other.