{"id":40394315,"url":"https://github.com/gardenlinux/gardenlinux","last_synced_at":"2026-04-02T13:31:09.948Z","repository":{"id":36950366,"uuid":"245713798","full_name":"gardenlinux/gardenlinux","owner":"gardenlinux","description":"Garden Linux - The best Linux for Gardener nodes!","archived":false,"fork":false,"pushed_at":"2026-01-12T16:02:20.000Z","size":12315,"stargazers_count":203,"open_issues_count":276,"forks_count":72,"subscribers_count":12,"default_branch":"main","last_synced_at":"2026-01-12T19:24:37.704Z","etag":null,"topics":["containers","debian","image-based","k8s","kubernetes","linux","os"],"latest_commit_sha":null,"homepage":"https://gardenlinux.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gardenlinux.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-07T22:17:18.000Z","updated_at":"2026-01-12T16:01:24.000Z","dependencies_parsed_at":"2024-10-29T09:39:09.793Z","dependency_job_id":null,"html_url":"https://github.com/gardenlinux/gardenlinux","commit_stats":null,"previous_names":[],"tags_count":81,"template":false,"template_full_name":null,"purl":"pkg:github/gardenlinux/gardenlinux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardenlinux%2Fgardenlinux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardenlinux%2Fgardenlinux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardenlinux%2Fgardenlinux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardenlinux%2Fgardenlinux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gardenlinux","download_url":"https://codeload.github.com/gardenlinux/gardenlinux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardenlinux%2Fgardenlinux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28603402,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T12:01:53.233Z","status":"ssl_error","status_checked_at":"2026-01-20T12:01:46.545Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["containers","debian","image-based","k8s","kubernetes","linux","os"],"created_at":"2026-01-20T13:01:16.552Z","updated_at":"2026-04-02T13:31:09.941Z","avatar_url":"https://github.com/gardenlinux.png","language":"Python","readme":"\u003cp style=\"text-align: center;\"\u003e\n    \u003ca href=\"https://github.com/gardenlinux/gardenlinux/releases\" target=\"_blank\"\u003e\n       \u003cimg src=\"https://img.shields.io/github/v/release/gardenlinux/gardenlinux?label=latest%20release\" alt=\"latest release\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/gardenlinux/gardenlinux/actions/workflows/nightly.yml\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://github.com/gardenlinux/gardenlinux/actions/workflows/nightly.yml/badge.svg?event=schedule\" alt=\"Nightly Build\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/gardenlinux/gardenlinux/actions/workflows/dev.yml\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://github.com/gardenlinux/gardenlinux/actions/workflows/dev.yml/badge.svg?branch=main\" alt=\"Dev Build\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://bestpractices.coreinfrastructure.org/projects/3925\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://bestpractices.coreinfrastructure.org/projects/3925/badge\" alt=\"CII Best Practices\"\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n# Garden Linux\n\n\u003cwebsite-main\u003e\n\n\u003cimg align=\"left\" width=\"80\" height=\"80\" src=\"https://raw.githubusercontent.com/gardenlinux/gardenlinux/main/logo/gardenlinux-logo-black-text.svg\"\u003e \u003ca href=\"https://gardenlinux.io/\"\u003eGarden Linux\u003c/a\u003e is a \u003ca href=\"https://debian.org/\"\u003eDebian GNU/Linux\u003c/a\u003e derivate that aims to provide small, auditable Linux images for most cloud providers (e.g. AWS, Azure, GCP etc.) and bare-metal machines. Garden Linux is the best Linux for \u003ca href=\"https://gardener.cloud/\"\u003eGardener\u003c/a\u003e nodes. Garden Linux provides great possibilities for customizing that is made by a highly customizable feature set to fit your needs. \u003cbr\u003e\u003cbr\u003e\n\n\u003c/website-main\u003e\n\n## !! Important !!\nStarting with the major version 2017 the versioning scheme has been changed to a semver compliant one comprised of a 3 numerical segment identifier (major.minor.patch). The \"old\" 2017.0 is now 2017.0.0 \n\n## Features\n- Easy to use build system\n- Repeatable and auditable builds\n- Small footprint\n- Purely systemd based (network, fstab etc.)\n- Initramfs is dracut generated\n- Running latest LTS Kernel\n- [MIT](https://github.com/gardenlinux/gardenlinux/blob/master/LICENSE.md) license\n- Security\n  - Fully immutable image(s) *(optional)*\n  - OpenSSL 3.5 *(default)*\n  - CIS Framework *(optional)*\n- Testing\n  - Unit tests (Created image testing)\n  - Platform tests (Image platform tests in all supported platforms)\n  - License violations (Testing for any license violations)\n  - Outdated software versions (Testing for outdated software)\n- Supporting major platforms out-of-the-box\n  - Major cloud providers AWS, Azure, Google, Alicloud\n  - Major virtualizer VMware, OpenStack, KVM\n  - Bare-metal systems\n\n# Build\n\nThe build system utilises the [gardenlinux/builder](https://github.com/gardenlinux/builder) to create customized Linux distributions.\n[gardenlinux/gardenlinux](https://github.com/gardenlinux/gardenlinux) is maintained by the Garden Linux team, highlighting specialized \"features\" available for other projects.\n\n\u003e [!TIP]\n\u003e For further information about the build process, and how to set it up on your machine, refer to [the _Build Image_ documentation page](docs/01_developers/build_image.md).\n\n\u003e [!WARNING]\n\u003e Be sure to provide enough memory (at least 8GiB) to your container runtime or the VM that hosts your container runtime (in Podman or Docker Desktop).\n\u003e Otherwise your build may fail silently.\n\nTo initiate a build, use the command:\n```bash\n./build ${platform}-${feature1}-${feature2}-${feature3}-${arch}\n```\n\nWhere:\n\n- `${platform}` denotes the desired platform (e.g., kvm, metal, aws). It should be the first part of the flavor that is built.\n- `${featureX}` represents one or more specific features from the `features/` folder. Features are appended and seperated by a hyphen `-` or (if the feature starts with an underscore `_`) by an underscore.\n- `${arch}` optinally you can reference a certain architecture `amd64` or `arm64`. It should be the last part of the flavor that is built.\n\nYou can combine multiple platforms and features as needed.\n\nExamples:\n```shell\n./build kvm-python_dev\n./build aws-gardener_prod-amd64\n```\n\nThe build script fetches the required builder container and manages all internal build steps. By default, it uses rootless podman, but you can switch to another container engine with the `--container-engine` flag.\n\nGarden Linux images can be built with the *trustedboot* feature—an extension to *secureboot*—for enhanced system integrity; see the [trustedboot documentation](features/_trustedboot/README.md) for build instructions.\n# Test\n\nTo run unit tests for a specific target, use the command `./test ${target}`.\nFurther documentation about tests is located in [tests/README.md](tests/README.md).\n\n# Releases\n\nFor more information about the release strategy and lifecycle, have a look at the [Release Plan Overview](docs/00_introduction/release.md). List of releases is available in the [Public Roadmap, Theme:\"Release Plan\"](https://github.com/orgs/gardenlinux/projects/15/views/1?filterQuery=theme%3A%22Release+Plan%22).\n\n\n## Download Garden Linux Releases\n\nImages are published as:\n- GitHub Releses in https://github.com/gardenlinux/gardenlinux/releases\n- GitHub Packages https://github.com/gardenlinux/gardenlinux/pkgs/container/gardenlinux\n\n## Download Nightly Releases \n\n[Nightly](docs/00_introduction/release.md#nightly-releases) releases can be downloaded from the same sources and are either tagged or named `nightly`.\n\n\u003e [!WARNING]  \n\u003e Nightly releases do not include maintenance commitments and never receive updates.\n\u003e Advanced users are invited to try them out and provide feedback, but it **is strongly discouraged** to use them in any sort of production environment.\n\n# Nvidia Driver Support\nAn installer can be found in the [gardenlinux/gardenlinux-nvidia-installer](https://github.com/gardenlinux/gardenlinux-nvidia-installer) repository.\n\n# Run Garden Linux Virtual Machines Locally Using Lima (Linux Machines)\n\nYou can run Garden Linux virtual machines on your laptop easily using [Lima (Linux Machines)](https://lima-vm.io).\nThis can be useful if you want to evaluate Garden Linux but don't have access to Cloud accounts.\n\nTo get started, follow the [lima install instructions](https://lima-vm.io/docs/installation/) for your OS and create a Garden Linux vm using this command:\n\n```bash\npodman run --rm ghcr.io/gardenlinux/gardenlinux/lima:latest | limactl start --name gardenlinux -\n```\n\nFor advanced use cases, read [the documentation page on Lima](./docs/02_operators/lima-vm.md).\n\n# Documentation\nPlease refer to [docs/README.md](https://github.com/gardenlinux/gardenlinux/tree/main/docs#readme).\n\n# Contributing\n\nContributions to the Garden Linux open source projects are welcome. \nMore information are available in in \u003ca href=\"CONTRIBUTING.md\"\u003eCONTRIBUTING.md\u003c/a\u003e and our `docs/`.\n\n# Community\nIf you need further assistance, have any issues or just want to get in touch with other Garden Linux users feel free to join our public chat room on Gitter.\n\nLink: \u003ca href=\"https://gitter.im/gardenlinux/community\"\u003ehttps://gitter.im/gardenlinux/community\u003c/a\u003e\n\n## Licensing\n\nCopyright 2025 SAP SE or an SAP affiliate company and GardenLinux contributors. Please see our [LICENSE](LICENSE.md) for\ncopyright and license information. Detailed information including third-party components and their licensing/copyright\ninformation is available [via the REUSE tool](https://reuse.software).\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"Bundesministerium für Wirtschaft und Energie (BMWE)-EU funding logo\" src=\"https://apeirora.eu/assets/img/BMWK-EU.png\" width=\"400\"/\u003e\n\u003c/p\u003e\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgardenlinux%2Fgardenlinux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgardenlinux%2Fgardenlinux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgardenlinux%2Fgardenlinux/lists"}