docker-entrypoint.sh fails when host user is root (UID 0)

[lroolle]

Description

docker-entrypoint.sh crashes with 'usermod: UID 0 already exists' when running claude-yolo as root user on host.

Type

• Bug fix
• New feature
• Enhancement
• Documentation

Details

Problem: When host user is root (UID=0), docker-entrypoint.sh tries to create claude user with UID=0, but root user already exists with UID=0.

Error:
usermod: UID '0' already exists

Root Cause:

• Host passes CLAUDE_UID=$(id -u) to container
• When host user is root, CLAUDE_UID=0
• Container tries: usermod -u 0 claude
• Fails because root (UID=0) already exists

Solution:
Detect UID=0 case and handle specially - either skip usermod or use fallback UID.

Related Files

• docker-entrypoint.sh (UID/GID setup logic)
• claude.sh (UID/GID detection and passing)

Test Plan

• Test claude-yolo as root user on Linux host
• Test claude-yolo as non-root user (existing case)
• Verify file permissions work correctly in both cases
• Test with custom CLAUDE_UID override

[lroolle]

@claude try resolve this issue thx

[claude]

Claude finished @lroolle's task —— View job • claude/issue-21-20250623_101208 • Create PR ➔

---

Fixing docker-entrypoint.sh UID 0 Issue ✅

I've successfully resolved the issue where docker-entrypoint.sh fails when the host user is root (UID 0).

Todo List:

• Read docker-entrypoint.sh to understand current UID/GID setup logic
• Read claude.sh to understand how UID/GID is detected and passed
• Analyze the problem and design a solution for UID=0 case
• Implement fix in docker-entrypoint.sh to handle root user scenario
• Test the solution (logic validated, Docker testing requires container environment)
• Commit changes to branch
• Provide PR creation link

Problem & Solution:

Problem: When host user is root (UID=0), docker-entrypoint.sh tried to run usermod -u 0 claude, which failed because UID 0 (root) already exists in the container.

Solution: Added detection for UID=0 case with fallback to UID 1000:

• Preserves security model (still runs as non-root in container)
• Avoids UID conflict with existing root user
• Displays clear warning messages
• Handles both UID=0 and GID=0 cases

Changes Made:

• docker-entrypoint.sh: Added UID=0 detection and fallback logic in setup_nonroot_user() function (lines 62-71)
• Clear warning messages inform users about the fallback behavior
• Files will be owned by root on host but container runs securely as non-root claude user

Commit:

• SHA: 31346329e2a46a6dc6795cd534d6e468816333d1
• Message: "fix: handle UID 0 (root user) case in docker-entrypoint.sh"

--- | Branch: claude/issue-21-20250623_101208