Image Overview: wolfi-base

Overview: wolfi-base Chainguard Image

Base image for the Wolfi Linux Distribution.

Download this Image

The image is available on

docker pull


The Chainguard wolfi-base Image includes a shell and package manager. The Image will start in a shell by default:

docker run -it

You can run commands from within the shell like this, or you can run commands directly on your local machine without opening a shell:

docker run ps
    1 root      0:00 ps

This Image is commonly used in Dockerfiles, as in the following example:


RUN apk update && apk add redis

ENTRYPOINT ["/usr/bin/redis-server"]

This example Dockerfile will update apk and install the Redis server onto the base Image.

You could use a Dockerfile like this to build a new image:

docker build -t myredis --progress plain --no-cache .
#0 building with "desktop-linux" instance using docker driver

#1 [internal] load .dockerignore
#1 transferring context: 656B done
#1 DONE 0.0s

#2 [internal] load build definition from Dockerfile
#2 transferring dockerfile: 144B done
#2 DONE 0.0s

#3 [internal] load metadata for
#3 DONE 0.0s

#4 [1/2] FROM

#5 [2/2] RUN apk update && apk add redis
#5 0.104 fetch
#5 0.702  []
#5 0.702 OK: 14620 distinct packages available
#5 0.750 (1/1) Installing redis (7.2.0-r0)
#5 1.207 OK: 15 MiB in 15 packages
#5 DONE 1.2s

#6 exporting to image
#6 exporting layers 0.0s done
#6 writing image sha256:bde1c89d952e0e0155acb410ee8143b1daf542bd36a6b22c032250633d08bf76 done
#6 naming to done
#6 DONE 0.0s

Following that, you can run the new image built from the wolfi-base Image.

docker run myredis

Further Reading

To learn more, we encourage you to visit Chainguard Academy which contains extensive documentation on getting started with Wolfi.

Last updated: 2024-04-11 12:38