Skip to content

docs: clarify setup.files permissions - #25899

Open
dvdksn wants to merge 1 commit into
docker:mainfrom
dvdksn:codex/docs-setup-files-permissions
Open

docs: clarify setup.files permissions#25899
dvdksn wants to merge 1 commit into
docker:mainfrom
dvdksn:codex/docs-setup-files-permissions

Conversation

@dvdksn

@dvdksn dvdksn commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

Summary

Clarify that setup.files runs as the non-root agent user with UID 1000 and requires an agent-writable target. Direct kit authors to setup.install when writing root-owned paths.

@netlify /ai/sandboxes/customize/kit-reference/

Closes docker/sbx-releases#467

Companion specification update: docker/sbx-kits-contrib#227

Preview the kit spec reference

Generated by Codex

The kit reference did not state that setup.files runs as the non-root agent user. Document the UID 1000 write restriction and direct root-owned path writes to setup.install.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
@netlify

netlify Bot commented Aug 20, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit e91e01b
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a86f6f15bcf430008245ba4
😎 Deploy Preview https://deploy-preview-25899--docsdocker.netlify.app/ai/sandboxes/customize/kit-reference/
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@dvdksn
dvdksn marked this pull request as ready for review August 20, 2026 12:49
@dvdksn
dvdksn requested a review from a team August 20, 2026 12:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add documentation on the limitations of setup.file

1 participant