Skip to content

Run the published kits from a dedicated folder - #15

Merged
mathieu-benoit merged 2 commits into
mainfrom
run-from-empty-folder
Nov 18, 2026
Merged

mathieu-benoit merged 2 commits into
mainfrom
run-from-empty-folder

Conversation

@mathieu-benoit

@mathieu-benoit mathieu-benoit commented Nov 18, 2026 •

Copy link
Copy Markdown
Owner

Feedback: running the published-kit command from the home directory fails with mount "/Users/<me>" overlaps Sandboxes configuration, state or credentials. It works from a dedicated folder (mkdir ~/sbx-lab && cd ~/sbx-lab).

The guidance is framed as a security practice: sbx run mounts the folder it starts from into the sandbox, read-write, so starting from the home directory would expose SSH keys, cloud and registry credentials, shell history and other projects to it. A content kit doesn't use the workspace, so an empty folder is all a lab needs. The sbx error is mentioned as a side note.

  • README.md, published kits section: the why, then mkdir -p ~/sbx-lab && cd ~/sbx-lab, then one run command per kit:
    • the built-in getting-started lab (Labspace kit only, -p 8085:8085)
    • hello-lab (-p 8085:8085 -p 3000:3000)
    • building-images (-p 8085:8085 -p 5050:5050)
  • README.md: the local content-kit example says "from the repo root" instead of "from any folder", and the open point about the mounted workspace says never to start from the home directory.
  • Built-in lab pages (03-content-kit.md, 04-one-reference.md): start from a dedicated, empty folder, never the home directory, with the same reason.

Not run end to end; the commands use the published 0.1.4 references.

🤖 Generated with Claude Code

mathieu-benoit and others added 2 commits November 18, 2026 11:07
sbx refuses to mount the home directory as the workspace, because it overlaps
the Sandboxes configuration, state and credentials. The README now starts the
published kits from an empty ~/sbx-lab folder and gives the run command for
each of them (the built-in lab, hello-lab and building-images). The built-in
lab's pages say the same.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The folder sbx run starts from is mounted into the sandbox, so starting from
the home directory would expose keys, credentials and other projects to it.
That, not the sbx refusal, is the reason to use an empty folder.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mathieu-benoit
mathieu-benoit merged commit ce9456f into main Nov 18, 2026
4 checks passed
@mathieu-benoit
mathieu-benoit deleted the run-from-empty-folder branch November 18, 2026 16:50
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