{"id":47004901,"url":"https://github.com/gardenlinux/gardenlinux-nvidia-installer","last_synced_at":"2026-04-07T12:00:55.846Z","repository":{"id":211305558,"uuid":"673838346","full_name":"gardenlinux/gardenlinux-nvidia-installer","owner":"gardenlinux","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-02T00:11:23.000Z","size":716,"stargazers_count":5,"open_issues_count":10,"forks_count":13,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-04-02T02:35:01.328Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gardenlinux.png","metadata":{"files":{"readme":"README.md","changelog":"history.yaml","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-08-02T14:35:13.000Z","updated_at":"2026-03-31T15:55:52.000Z","dependencies_parsed_at":"2026-04-01T21:02:25.985Z","dependency_job_id":null,"html_url":"https://github.com/gardenlinux/gardenlinux-nvidia-installer","commit_stats":null,"previous_names":["gardenlinux/gardenlinux-nvidia-installer"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/gardenlinux/gardenlinux-nvidia-installer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardenlinux%2Fgardenlinux-nvidia-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardenlinux%2Fgardenlinux-nvidia-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardenlinux%2Fgardenlinux-nvidia-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardenlinux%2Fgardenlinux-nvidia-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gardenlinux","download_url":"https://codeload.github.com/gardenlinux/gardenlinux-nvidia-installer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardenlinux%2Fgardenlinux-nvidia-installer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31511784,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2026-03-11T20:03:34.643Z","updated_at":"2026-04-07T12:00:55.839Z","avatar_url":"https://github.com/gardenlinux.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# nvidia-installer\n\nThis component installs NVIDIA kernel modules on Garden Linux nodes at runtime via the NVIDIA GPU Operator. Pre-compiled\nkernel modules are baked into the image at build time.\n\n## Deploying NVIDIA GPU Operator with Helm\n\n```bash\nhelm upgrade --install -n gpu-operator gpu-operator nvidia/gpu-operator \\\n  --values https://raw.githubusercontent.com/gardenlinux/gardenlinux-nvidia-installer/refs/tags/1.6.2/helm/gpu-operator-values.yaml\n```\n\nBuilt images are published at:\n\n```\nghcr.io/gardenlinux/gardenlinux-nvidia-installer/\u003crelease\u003e/driver:\u003cdriver_major\u003e-\u003ckernel_version\u003e-gardenlinux0\n```\n\nFor example: `ghcr.io/gardenlinux/gardenlinux-nvidia-installer/1.6.2/driver:590-6.12.72-cloud-amd64-gardenlinux0`\n\nIf you have built the images yourself, override the registry and image name:\n\n```bash\nhelm upgrade --install -n gpu-operator gpu-operator nvidia/gpu-operator \\\n  --values https://raw.githubusercontent.com/gardenlinux/gardenlinux-nvidia-installer/refs/tags/1.6.2/helm/gpu-operator-values.yaml \\\n  --set driver.repository=$REGISTRY/$FOLDER \\\n  --set driver.image=$IMAGE\n```\n\n### Kernel module type selection at runtime\n\nThe `KERNEL_MODULE_TYPE` environment variable controls which pre-compiled tarball the container downloads:\n\n| Value              | Behaviour                                       |\n|--------------------|-------------------------------------------------|\n| `auto` *(default)* | Detects the correct type at runtime (see below) |\n| `open`             | Always use open kernel modules                  |\n| `proprietary`      | Always use proprietary kernel modules           |\n\nIn `auto` mode the container picks the module type based on two checks:\n\n1. **Driver version** — driver branches older than 560 ship proprietary modules only.\n2. **GPU architecture** — NVIDIA open kernel modules require Turing (2018) or newer. GPUs from the Maxwell (e.g. M40),\n   Pascal (e.g. P100), or Volta (e.g. V100) architectures are only supported by the proprietary modules. The container\n   detects this at runtime by reading PCI device IDs from the host.\n\nSet `KERNEL_MODULE_TYPE` explicitly as a container environment variable when deploying via the GPU Operator to override\nthe auto-detection.\n\n**Important note:** with Garden Linux versions 1592.14 and earlier, only proprietary kernel modules will work. This is\nhandled by the \"auto\" logic only in releases 1.2.1 and later.\n\n\n## Supported versions\n\n```bash\npython3 list_versions.py\n```\n\nExample output:\n\n\u003c!-- list_versions_output_start --\u003e\n```\n\nSupported OS ↔ Driver Versions\n---------------------------------------------\nOS 1592.14: 590.48.01, 580.126.20, 570.211.01, 570.195.03, 565.57.01, 550.163.01\nOS 1592.15: 590.48.01, 580.126.20, 580.126.09, 580.105.08, 570.211.01, 570.195.03\nOS 1592.16: 590.48.01, 580.126.20, 580.126.16, 580.126.09, 570.211.01\nOS 1592.17: 590.48.01, 580.126.20, 570.211.01\nOS 1592.18: 590.48.01, 580.126.20, 570.211.01\nOS 1877.10: 590.48.01, 580.126.20, 580.126.09, 570.211.01\nOS 1877.11: 590.48.01, 580.126.20, 580.126.16, 570.211.01\nOS 1877.12: 590.48.01, 580.126.20, 570.211.01\nOS 1877.13: 590.48.01, 580.126.20, 570.211.01\nOS 1877.14: 590.48.01, 580.126.20, 570.211.01\nOS 2150.0.0: 590.48.01, 580.126.20, 570.211.01\nOS 2150.1.0: 590.48.01, 580.126.20, 570.211.01\n\n\nLifecycle for Driver and supported GL version depends on Garden Linux Release and Driver Release\n\nRefer below links for Garden Linux and driver releases\n\nGarden Linux Release: https://github.com/gardenlinux/gardenlinux/releases\n\nDriver Release: https://www.nvidia.com/en-us/drivers/ --\u003e Select Data Center/Tesla\n```\n\u003c!-- list_versions_output_end --\u003e\n\n## Driver lifecycle\n\nThis project tracks the **three** most recent NVIDIA driver major versions. Minor driver releases and Garden Linux \nversion updates are applied automatically via CI; major driver version bumps are handled manually.\n\n- **Garden Linux versions** are tracked from https://github.com/gardenlinux/gardenlinux/releases\n- **NVIDIA driver versions** are tracked from https://www.nvidia.com/en-us/drivers/\n\n## Background\n\nGarden Linux ships without build tools and without accessible kernel sources on the running node. This project solves\nthat by compiling kernel modules at image-build time inside the Garden Linux `kmodbuild` developer container (which\ncontains the correct kernel headers and compiler toolchain). The compiled modules are packaged into tarballs, published\nto GitHub Releases, and downloaded by the installer container at runtime immediately before installation.\n\n## Development\n\nFor instructions on building the driver tarballs and container images locally and working with the build system, \nsee [README-developers.md](README-developers.md).\n\n## Disclaimer\n\nDrivers built with this project are only supported on Garden Linux. Only data center (non-consumer) graphics cards are\nsupported.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgardenlinux%2Fgardenlinux-nvidia-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgardenlinux%2Fgardenlinux-nvidia-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgardenlinux%2Fgardenlinux-nvidia-installer/lists"}