Skip to content

docs: explain volume permissions and UID 10001 requirements#85

Merged
majinghe merged 1 commit intorustfs:mainfrom
Leprekus:docs/volume-permissions-fix
Apr 8, 2026
Merged

docs: explain volume permissions and UID 10001 requirements#85
majinghe merged 1 commit intorustfs:mainfrom
Leprekus:docs/volume-permissions-fix

Conversation

@Leprekus
Copy link
Copy Markdown
Contributor

@Leprekus Leprekus commented Apr 7, 2026

This PR addresses the "Permission Denied (os error 13)" issue encountered when using bind-mounted volumes. Because RustFS runs as a non-root user (UID 10001), host directories often lack the necessary write permissions by default.
Changes:

  • Prerequisites: Added the explicit chown command to the host requirements section to help CLI users set up permissions manually.

  • Docker Compose: Added a new section and code snippet demonstrating how to use an init container (rustfs_perms) with depends_on to automate permission handling.

Closes #2396

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 7, 2026

@Leprekus is attempting to deploy a commit to the overtrue's projects Team on Vercel.

A member of the Team first needs to authorize it.

@majinghe majinghe merged commit 044eeef into rustfs:main Apr 8, 2026
1 check failed
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.

[BUG] Permission Denied (os error 13) on bind-mounted volumes due to UID mismatch

2 participants