Skip to content

Granting toolchain folders to the sandbox ​

With the default sandbox, the sandbox reads the system folders, the Homebrew and /usr/local program folders and /nix. It also reads the one mise install folder each of bun, node and pi resolves to. The sandbox also reads the checks kit’s shared clone cache in $HOME/.cache/avi2dg-checks, so a copy’s prepare step can verify its dependencies. With the default sandbox, orc refuses a runtime the PATH finds anywhere else, naming the runtime and its path. To run a runtime from another install folder, such as the one Bun's own installer makes in your home:

  1. Set ORC_TOOLCHAIN_DIRS to the install folders, separated by colons.
  2. Run the task as usual.

With the default sandbox, orc grants a named folder only when a runtime and the file its link points to both sit inside it. Orc refuses a relative entry and a folder that holds HOME, because the sandbox reads each granted folder whole.

packages/run/src/shared/sandbox/nono-profile.ts holds the ToolchainResolver interface and the default layout, and packages/run/src/shared/sandbox/nono-exec.ts takes another resolver through its toolchain option.