https://github.com/void-linux/void-containers
OCI container images for Void Linux
https://github.com/void-linux/void-containers
voidlinux
Last synced: 7 months ago
JSON representation
OCI container images for Void Linux
- Host: GitHub
- URL: https://github.com/void-linux/void-containers
- Owner: void-linux
- License: other
- Created: 2021-02-20T23:22:08.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2025-06-16T04:51:44.000Z (8 months ago)
- Last Synced: 2025-06-16T05:39:12.338Z (7 months ago)
- Topics: voidlinux
- Language: Dockerfile
- Homepage: https://voidlinux.org
- Size: 38.1 KB
- Stars: 82
- Watchers: 16
- Forks: 14
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# Void Linux Container Images
This repo contains what is needed to build void-linux OCI container
images. There are 3 images provided for each libc (`glibc` or `musl`):
- `void-LIBC`: This image contains far fewer packages and uses a
`noextract` file to prevent certain directories from being added to
the image. These images average 40-65MB.
- `void-LIBC-full`: Large image based on the `base-container` package and
does not contain a `noextract` configuration. If you want something
that is as close to a full void VM as possible, this is the image you
want to start with.These images average 80-135MB.
- `void-LIBC-busybox`: This image is the same as the `void-LIBC` image
above, but uses busybox instead of GNU coreutils. Note that this is
not a well tested configuration with Void, but if you want a very
small image, busybox is a good way to get it. These images average 15-40MB.
These images are available for the following OCI platforms:
- `linux/amd64`
- `linux/386` (`glibc` only)
- `linux/arm64`
- `linux/arm/v7`
- `linux/arm/v6`
```
REPOSITORY TAG SIZE
ghcr.io/void-linux/void-glibc latest 64.5MB
ghcr.io/void-linux/void-musl latest 40.3MB
ghcr.io/void-linux/void-glibc-full latest 135MB
ghcr.io/void-linux/void-musl-full latest 81.4MB
ghcr.io/void-linux/void-glibc-busybox latest 39.6MB
ghcr.io/void-linux/void-musl-busybox latest 14.4MB
```
## Building locally
With `docker` and `docker-buildx`:
1. Install and set up `docker` and `docker-buildx`. If building multi-platform images,
`qemu-user-static`, and `binfmt-support` are also needed:
```sh
xbps-install docker docker-buildx
ln -s /etc/sv/docker /var/service
# optional
xbps-install binfmt-support
ln -s /etc/sv/binfmt-support /var/service
xbps-install qemu-user-static
```
2. Build the image:
```sh
docker build --target "image-" -f Containerfile --build-arg="LIBC=" . --tag
```
> Note: To easily build multi-platform images, `docker buildx bake` can be used.
With `podman`:
1. Install and set up `podman`.
2. Build the image:
```sh
podman build --target "image-" --build-arg="LIBC=" . --tag
```