Skip to content

fix(docs): Added group_add configuration for ROCm support in Docker. - #2857

Open
storm1er wants to merge 5 commits into
lemonade-sdk:mainfrom
storm1er:patch-1
Open

fix(docs): Added group_add configuration for ROCm support in Docker.#2857
storm1er wants to merge 5 commits into
lemonade-sdk:mainfrom
storm1er:patch-1

Conversation

@storm1er

Copy link
Copy Markdown
Contributor

Since lemonade v11.0.0, docker lemonade is not root anymore, so we need to give container user permission to /dev/kri and /dev/kfd

Since lemonade v11.0.0, docker lemonade is not root anymore, so we need to give container user permission to /dev/kri and /dev/kfd
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jul 30, 2026
@jeremyfowers
jeremyfowers requested a review from siavashhub July 30, 2026 16:28

@siavashhub siavashhub left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for this! it's a genuinely useful addition, since the permissions got changed from 10.10 to unprivileged user (UID 10001) and that container user needs to be in the host's GPU groups for ROCm device access to work.

I've left a few suggestions to make it robust for everyone:

  1. Hardcoded GID 992 is host-specific: the numeric ID for render/video varies per machine, so it'll silently fail for many users. Better to use the group names and tell people how to find the numeric IDs (getent group render video) as a fallback.
  2. Compose block placement: the devices/group_add additions apply only to ROCm on Linux, so it's worth flagging that so non-AMD users don't copy /dev/kfd and hit errors.

Comment thread docs/guide/install/docker.md Outdated
Comment thread docs/guide/install/docker.md
Comment thread docs/guide/install/docker.md
Comment thread docs/guide/install/docker.md Outdated
storm1er and others added 4 commits July 31, 2026 12:03
Co-authored-by: Siavash Yousefi <61756513+siavashhub@users.noreply.github.com>
Co-authored-by: Siavash Yousefi <61756513+siavashhub@users.noreply.github.com>
…features

Co-authored-by: Siavash Yousefi <61756513+siavashhub@users.noreply.github.com>
@siavashhub

siavashhub commented Aug 1, 2026

Copy link
Copy Markdown
Collaborator

looks good to me
Thank you!

@siavashhub
siavashhub enabled auto-merge August 1, 2026 16:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants