Skip to content

docs(secure-boot): add DKMS/MOK kernel module signing section#482

Draft
mbocevski wants to merge 1 commit into
CachyOS:nextfrom
mbocevski:docs-secure-boot-dkms-mok
Draft

docs(secure-boot): add DKMS/MOK kernel module signing section#482
mbocevski wants to merge 1 commit into
CachyOS:nextfrom
mbocevski:docs-secure-boot-dkms-mok

Conversation

@mbocevski
Copy link
Copy Markdown

Blocked on CachyOS/linux-cachyos#863 — please don't merge until that kernel change ships. It documents behaviour that only works once IMA is enabled, so I'm opening it as a draft for visibility and feedback alongside that PR.

Adds a "Signing Kernel Modules (DKMS / MOK)" section to the Secure Boot article. It covers how to get MOK-signed DKMS modules (e.g. openrazer) to load under Secure Boot: DKMS signs them with /var/lib/dkms/mok.key, and the key has to be enrolled as a MOK — via shim, since the sbctl setup has no shim — so the kernel trusts it in the .machine keyring. English .mdx only; translations are handled by the usual Lunaria workflow.

Document how to get MOK-signed DKMS modules (nvidia, openrazer, etc.) to
load under Secure Boot: DKMS signs with /var/lib/dkms/mok.key, and the key
must be enrolled as a MOK (via shim, since the sbctl setup has no shim) so
the kernel trusts it in the .machine keyring.

Requires a CachyOS kernel built with IMA (CONFIG_IMA_SECURE_AND_OR_TRUSTED_BOOT);
see CachyOS/linux-cachyos#862 and #863.
@mbocevski mbocevski force-pushed the docs-secure-boot-dkms-mok branch from c0901aa to 85263d9 Compare June 1, 2026 11:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant