Garden Linux

Appearance

OCI Platform ​

Garden Linux provides Open Container Initiative (OCI) compliant container images. This page covers the platform-specific build process and references the comprehensive base image guide.

OCI Image Build Process ​

Garden Linux uses the features/container feature to produce OCI images:

  • Build output: .tar.gz archive in docker-archive format, compatible with Docker and Podman
  • Default command: /bin/bash
  • OCI metadata: Image is tagged with title, version, architecture, source, revision, and description

For details on the build mechanism, see features/container/README.md and features/container/image.oci in the repository.

Using Garden Linux as a Base Image ​

For comprehensive documentation on using Garden Linux container images as base images in your own Containerfiles and Dockerfiles — including both full and bare (distroless-style) images — see the dedicated guide:

Container Base Image

This guide covers:

  • Full container base images (using ghcr.io/gardenlinux/gardenlinux:<version>)
  • Bare container images (bare-libc, bare-python, bare-nodejs, bare-sapmachine)
  • Multi-stage build patterns for adding dependencies
  • Debugging bare containers

Further Reading ​