Skip to content

feature: support PUID/PGID to change user - #655

Merged
C4illin merged 7 commits into
mainfrom
feature/support-PUID-PGID
Sep 23, 2026
Merged

C4illin merged 7 commits into
mainfrom
feature/support-PUID-PGID

Conversation

@C4illin

@C4illin C4illin commented Sep 22, 2026

Copy link
Copy Markdown
Owner

Inspired by linuxserver.io to be able to change the user in an easier way. Default to root for now to not make this a breaking change in any way


Summary by cubic

Adds PUID/PGID support so the container can run as a non-root user, inspired by linuxserver.io. The app still defaults to running as root, so existing setups are unaffected.

  • New entrypoint.sh validates that PUID/PGID are numeric, remaps the convertx user to the given IDs, chowns /app/data only when mount ownership differs, and launches the app via gosu.
  • New PUID, PGID, and UMASK environment variables control the runtime user and file creation mask.
  • Added gosu to the image and documented the new variables in the README and example compose file.

Written for commit 59d94a7. Summary will update on new commits.

Review in cubic

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

All reported issues were addressed across 4 files

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread entrypoint.sh Outdated
Comment thread compose.yaml Outdated
Comment thread README.md Outdated
Comment thread entrypoint.sh Outdated
Comment thread entrypoint.sh
Comment thread README.md Outdated
@C4illin
C4illin merged commit 4750fdf into main Sep 23, 2026
12 checks passed
@C4illin
C4illin deleted the feature/support-PUID-PGID branch September 23, 2026 21:27
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