How-To Guides
How-to guides are task-oriented directions that guide you through solving a specific problem or achieving a particular goal. They assume you have some familiarity with Garden Linux and focus on practical solutions.
Available How-to documentation
Choosing FlavorsHow to select the right Garden Linux flavor for your workload
Getting ImagesHow to obtain pre-built Garden Linux images
Building ImagesStep-by-step guide to building Garden Linux images locally with the Builder
Container Base ImageHow to use Garden Linux full and bare (distroless-style) OCI container images as base images in Containerfiles and Dockerfiles
Bare Container Base ImagesHow to use Garden Linux bare (distroless-style) OCI container images as base images in Containerfiles and Dockerfiles
Full Container Base ImagesHow to use Garden Linux full OCI container images as base images in Containerfiles and Dockerfiles
Building a custom FeatureCreate a custom Feature and build an image with the Builder
Post Installation StepsSuggested First Steps after Installation
Kernel BuildsHow to build a Garden Linux Kernel
PackagingComprehensive guide to the Garden Linux packaging system and release lifecycle
Creating PackagesLearn how to create Garden Linux Packages
PatchingLearn how to create and update Patches for Garden Linux Packages
Local Package BuildingLearn how Garden Linux Packages are built locally
Github Actions Package BuildingLearn how Garden Linux Packages are built in Github Actions
Patch Releases and BackportingLearn how to update and backport Garden Linux Packages
Build DependenciesLearn how to create and manage one-shot build dependencies
NULL ReleasesLearn how to use NULL releases to exclude Packages frin Garden Linux builds
Removing Packages from RepositoryProcedure to switch back to Debian-provided packages instead of Garden Linux-built packages
Release Process - Python LibraryRelease a new version of the Garden Linux Python Library
Creating Package ReleasesComprehensive guide to creating Garden Linux Package releases
Creating APT Repository ReleasesComprehensive guide to creating releases for Garden Linux APT repositories
Creating OS ReleasesComprehensive guide to creating Garden Linux OS major and minor releases
Reporting IssuesHow to report issues when working with garden linux
Deploying Secure Boot ImagesHow to deploy Garden Linux images with Secure Boot and Trusted Boot on cloud providers
TestingHow-to guides for running and debugging Garden Linux tests
Debug TestsLearn how to Troubleshoot and Debug Garden Linux Tests
Run TestsHow to run Garden Linux tests in chroot, QEMU, cloud, OCI, and Kubernetes environments
Setup Test EnvironmentInstall prerequisites and dependencies for running Garden Linux tests
Test in CloudRun Garden Linux tests on cloud providers with authentication and configuration guides
About How-To Guides: Following the Diátaxis framework, how-to guides are recipes that lead you through the steps to solve a real-world problem. Unlike tutorials, they don't aim to teach concepts but rather to help you accomplish a specific task efficiently.