About

A lightweight container image distribution of s6-overlay using an explicitly empty image (FROM scratch).

Source | Docker Hub | GitHub Container Registry

Image

Registry	Image
Docker Hub	socheatsok78/s6-overlay
GitHub Container Registry	ghcr.io/socheatsok78/s6-overlay

Following platforms for this image are available:

$ docker run --rm mplatform/mquery socheatsok78/s6-overlay:v3.2.0.0

# Image: socheatsok78/s6-overlay:v3.2.0.0
#  * Manifest List: Yes (Image type: application/vnd.oci.image.index.v1+json)
#  * Supported platforms:
#    - linux/amd64
#    - linux/arm64
#    - linux/riscv64
#    - linux/s390x
#    - linux/386
#    - linux/arm/v7
#    - linux/arm/v6

Usage

Here a simple example of how to use this image:

# example/Dockerfile

ARG S6_VERSION=v3.2.0.0
FROM socheatsok78/s6-overlay:${S6_VERSION} AS s6-overlay

# This is your final image
FROM alpine:latest

# Overlay the s6-overlay files to the root filesystem
# The order of this is up to you, but generally, you want to copy the main s6-overlay first,
# followed by symlinks and syslogd if needed.
COPY --link --from=s6-overlay / /
ENTRYPOINT [ "/init" ]
CMD [ "/bin/sh" ]

# Add any additional packages or configurations you need here

This distribution will includes all default binaries and symlinks.

• s6-overlay-noarch.tar.xz
• s6-overlay-${S6_ARCH}.tar.xz

If you need to include symlinks to the s6-overlay binaries, you can add the following to your Dockerfile:

ARG S6_VERSION=v3.2.0.0
FROM socheatsok78/s6-overlay:${S6_VERSION} AS s6-overlay
+FROM socheatsok78/s6-overlay:${S6_VERSION}-symlinks AS s6-overlay-symlinks

FROM alpine:latest
COPY --link --from=s6-overlay / /
+COPY --link --from=s6-overlay-symlinks / /

Also available for syslogd service, use -syslogd suffix:

ARG S6_VERSION=v3.2.0.0
FROM socheatsok78/s6-overlay:${S6_VERSION} AS s6-overlay
+FROM socheatsok78/s6-overlay:${S6_VERSION}-syslogd AS s6-overlay-syslogd

FROM alpine:latest
COPY --link --from=s6-overlay / /
+COPY --link --from=s6-overlay-syslogd / /

Versioning

The container images are tagged with the version of s6-overlay starting from v3.2.0.0. Any future versions will be tagged accordingly.

Please check the releases page for the latest version of s6-overlay.

Development

Before building the image, ensure you have the following tools installed:

• Docker
• Buildx
• tonistiigi/binfmt - Cross-platform emulator collection distributed with Docker images.

Run the following command to generate the build artifacts for the image:

$ ./update.sh

The update.sh script parse through the s6-overlay release assets and generate the docker-bake.hcl file with the appropriate build targets for each architecture.

License

Licensed under the MIT License.