Skip to content
This repository was archived by the owner on Jul 17, 2026. It is now read-only.

Commit b3d071f

Browse files
docs: clarify that setup commands run as root and repo location
- Add information about setup commands running as root user - Specify that repositories are cloned to /workspace directory - Add example for running commands as non-root user (e.g., for Homebrew) Co-authored-by: Jay Hack <jay@codegen.com>
1 parent 782db11 commit b3d071f

1 file changed

Lines changed: 13 additions & 1 deletion

File tree

‎docs/sandboxes/setup-commands.mdx‎

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,13 @@ To configure setup commands for a repository:
3131

3232
Enter your desired setup commands in the provided text area, with one command per line. These commands will be executed in sequence within the sandbox environment.
3333

34+
<Info>
35+
**Important Environment Details:**
36+
- All setup commands run as the **root** user
37+
- Your repository is cloned to the **/workspace** directory
38+
- If you need to run commands as a non-root user, use `su <username> -c "command"` (e.g., `su linuxbrew -c "brew install <package>"`)
39+
</Info>
40+
3441
For example, you might want to:
3542

3643
- Switch to a specific Node.js version.
@@ -67,6 +74,12 @@ npm ci
6774
npm run build
6875
```
6976

77+
```bash
78+
# Running commands as a non-root user (e.g., for Homebrew)
79+
su linuxbrew -c "brew install postgresql"
80+
su linuxbrew -c "brew services start postgresql"
81+
```
82+
7083
### Working with Different Python Versions
7184

7285
The sandbox comes with Python 3.13 by default, but some packages may not yet be compatible with this version. Here are strategies for handling different Python versions:
@@ -144,4 +157,3 @@ deactivate
144157
The environment variables listed in the "Env Variables" section are available
145158
during the execution of these setup commands.
146159
</Tip>
147-

0 commit comments

Comments
 (0)