stripe-projects

E2B Stripe Projects

Use these patterns after E2B sandbox/API access has been provisioned through Stripe Projects.

Credentials

• Stripe Projects provisions E2B sandbox/API access and returns an E2B team API key.
• Use that key as E2B_API_KEY for sandbox creation, sandbox control, and SDK clients.
• Prefer setting E2B_API_KEY explicitly in runtime environments so commands and SDK calls use the intended E2B team.
• Local defaults can also come from .env.local or ~/.e2b/config.json.
• In Stripe Projects checkouts, the E2B CLI may not be globally logged in. Before using e2b sandbox ..., prefer a Stripe Projects env pull plus per-command export instead of trying e2b auth login.
• Do not print secret values. stripe projects env --json can return redacted placeholders, so do not use it as the source for a runnable E2B_API_KEY. Pull the managed env file, then read only the needed E2B variables into the command environment without echoing them.

stripe projects env --pull --yes
env_value() {
  awk -F= -v key="$1" '$1 == key {sub(/^[^=]*=/, ""); gsub(/^"|"$/, ""); print; exit}' .env
}
export E2B_API_KEY="$(env_value E2B_API_KEY)"
export E2B_API_URL="$(env_value E2B_API_URL)"
export E2B_DOMAIN="$(env_value E2B_DOMAIN)"
e2b sandbox create base --detach

Stripe Projects CLI

Add E2B to the current Stripe project:

stripe projects add e2b/sandboxes

Inspect or pull provisioned credentials:

stripe projects env
stripe projects env --json
stripe projects env --pull --yes

Export the E2B API key before using the E2B CLI or SDK. Prefer stripe projects env --pull --yes for command execution because JSON output may redact secret values. Read only the variables you need from .env; do not source .env as shell code:

stripe projects env --pull --yes
env_value() {
  awk -F= -v key="$1" '$1 == key {sub(/^[^=]*=/, ""); gsub(/^"|"$/, ""); print; exit}' .env
}
export E2B_API_KEY="$(env_value E2B_API_KEY)"
export E2B_API_URL="$(env_value E2B_API_URL)"
export E2B_DOMAIN="$(env_value E2B_DOMAIN)"

Use stripe projects env --json for structure checks only. In current Stripe Projects output, the E2B variables are under data.resource_access_configurations[].access_configuration, including E2B_API_KEY, E2B_API_URL, and E2B_DOMAIN, but the values may be redacted and unusable for CLI/SDK calls.

E2B CLI

If the E2B CLI is missing or a shell shim is broken, install it with Node instead of switching to SDK code:

if ! e2b --version >/dev/null 2>&1; then
  npm install -g @e2b/cli
fi

The CLI package requires Node 20 or newer.

Prefer detached sandboxes for non-interactive work so the command returns a sandbox ID and does not attach an interactive terminal:

e2b sandbox create --detach
e2b sandbox create base --detach

Run shell commands in a sandbox with -- before shell flags so the CLI does not parse them:

e2b sandbox exec <sandbox_id> -- bash -lc 'pwd && ls -la'

For long-running processes, run them in the background and write a PID file in the sandbox:

e2b sandbox exec <sandbox_id> -- bash -lc 'nohup python server.py >server.log 2>&1 & echo $! >server.pid'

The CLI has explicit resume, but sandbox creation does not currently expose an auto-resume flag:

e2b sandbox resume <sandbox_id>

Use sandbox exec for operational commands against an existing sandbox:

e2b sandbox exec <sandbox_id> -- bash -lc 'python --version'
e2b sandbox exec <sandbox_id> -- bash -lc 'ls -la /tmp'

JavaScript SDK

Use Sandbox.create() with E2B_API_KEY for a fresh sandbox:

import Sandbox from 'e2b'

const sandbox = await Sandbox.create('base')
const result = await sandbox.commands.run('echo "hello from e2b"')
console.log(result.stdout)

Use lifecycle options when the sandbox should pause on timeout and resume on later activity:

const sandbox = await Sandbox.create('base', {
  lifecycle: { onTimeout: 'pause', autoResume: true },
})

Use Sandbox.connect() when a CLI step already created the sandbox:

import Sandbox from 'e2b'

const sandbox = await Sandbox.connect(process.env.SANDBOX_ID!)
const result = await sandbox.commands.run('cat important_file.md')
console.log(result.stdout)

Python SDK

Use the context manager with E2B_API_KEY for short-lived tasks:

from e2b import Sandbox

with Sandbox.create("base") as sandbox:
    result = sandbox.commands.run('echo "hello from e2b"')
    print(result.stdout)

Use lifecycle options when the sandbox should pause on timeout and resume on later activity:

sandbox = Sandbox.create(
    "base",
    lifecycle={"on_timeout": "pause", "auto_resume": True},
)

For workflows that share a sandbox across steps, keep the sandbox ID and connect to it later:

from e2b import Sandbox

sandbox = Sandbox.connect(sandbox_id)
result = sandbox.commands.run("cat important_file.md")
print(result.stdout)

Practical Defaults

• Use the base template unless a task requires a specific template.
• Prefer bash -lc for multi-command CLI execution.
• Put temporary files under /tmp or the current working directory inside the sandbox unless the task requires a specific path.
• For workloads that need code execution with run_code or runCode, use the Code Interpreter SDK.