{"id":17888271,"url":"https://github.com/squat/modulus","last_synced_at":"2025-03-22T19:33:55.274Z","repository":{"id":46815608,"uuid":"86631064","full_name":"squat/modulus","owner":"squat","description":"Automatically compile kernel modules for Flatcar Linux / CoreOS Container Linux","archived":false,"fork":false,"pushed_at":"2023-10-09T11:21:03.000Z","size":161,"stargazers_count":35,"open_issues_count":0,"forks_count":9,"subscribers_count":4,"default_branch":"main","last_synced_at":"2023-10-09T12:32:49.335Z","etag":null,"topics":["container-linux","coreos","drivers","flatcar","flatcar-linux","gpu","kernel-modules","kubernetes","nvidia"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/squat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-03-29T21:28:29.000Z","updated_at":"2023-10-07T19:44:00.000Z","dependencies_parsed_at":"2022-09-06T23:12:18.175Z","dependency_job_id":null,"html_url":"https://github.com/squat/modulus","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/squat%2Fmodulus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/squat%2Fmodulus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/squat%2Fmodulus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/squat%2Fmodulus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/squat","download_url":"https://codeload.github.com/squat/modulus/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221832797,"owners_count":16888318,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["container-linux","coreos","drivers","flatcar","flatcar-linux","gpu","kernel-modules","kubernetes","nvidia"],"created_at":"2024-10-28T13:36:58.877Z","updated_at":"2024-10-28T13:36:59.324Z","avatar_url":"https://github.com/squat.png","language":"Shell","readme":"# modulus\nAutomatically compile kernel modules for Flatcar Linux.\n\n[![Build Status](https://github.com/squat/modulus/workflows/CI/badge.svg)](https://github.com/squat/modulus/actions?query=workflow%3ACI)\n\n## Installation\nTo deploy Modulus to a Kubernetes cluster to install and maintain NVIDIA GPU drivers, run:\n```sh\nkubectl apply -f https://raw.githubusercontent.com/squat/modulus/main/nvidia/daemonset.yaml\n```\n\n## Background\nCompiling drivers on Flatcar Linux is typically non-trivial because the OS ships without build tools and no obvious way to access the kernel sources.\nModulus works by compiling your kernel modules inside of a Flatcar Linux developer Flatcar as documented in [[1](https://github.com/coreos/docs/blob/master/os/kernel-modules.md)] and used in [[2](https://github.com/Clarifai/coreos-nvidia)].\nFurthermore, because Flatcar Linux updates automatically to keep your machine secure, your kernel modules can easily become out of date.\nModulus automatically compiles kernel modules for the new version of Flatcar Linux when your OS is upgrading so that the new modules are available when your machine restarts.\nModulus can be used as a Kubernetes DaemonSet to maintain worker nodes up to date or as a systemd template unit and can be coupled with any script that compiles kernel modules.\nThis project currently supports generating NVIDIA and WireGuard kernel modules, however it can be extended to support any module.\n\n[1] https://github.com/coreos/docs/blob/master/os/kernel-modules.md\n\n[2] https://github.com/Clarifai/coreos-nvidia\n\n## Compiling NVIDIA Kernel Modules\nModulus makes it easy to automatically compile kernel modules for NVIDIA GPUs. See the [NVIDIA README](https://github.com/squat/modulus/blob/main/nvidia/README.md) for detailed instructions.\n\n## Compiling WireGuard Kernel Modules\nSee the [WireGuard README](https://github.com/squat/modulus/blob/main/wireguard/README.md) for detailed instructions.\n\n## Distribution\nAfter compiliation, Modulus installs all the compiled assets and caches them on disk. Modulus also automatically tries to upload your compiled kernel modules to S3 so that you can compile the drivers once and reuse them across multiple machines. To enable this functionality, provide the following environment variables to the Modulus DaemonSet:\n\n```\nAWS_ACCESS_KEY_ID=\u003cyour-aws-access-key-id\u003e\nAWS_SECRET_ACCESS_KEY=\u003cyour-aws-secret-access-key\u003e\nMODULUS_S3_BUCKET=s3://your.s3/bucket-name/\n```\n\n## Systemd Installation\nModulus can also be used as a set of Systemd services without depending on Kubernetes:\n```sh\nsudo git clone https://github.com/squat/modulus.git /opt/modulus\nsudo cp /opt/modulus/modulus@.service /etc/systemd/system/modulus@.service\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquat%2Fmodulus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsquat%2Fmodulus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquat%2Fmodulus/lists"}