// Troubleshoot Daytona sandbox runs, SSH access, snapshots, credentials, and command execution failures.
Use when working with Daytona SDK - uploadFile(Buffer, path), pnpm setup, CodeLanguage options
Daytona sandbox security. Use for token handling, credential boundaries, and full paths in SSH.
Prepare reusable Daytona sandbox sessions for isolated evals, debugging, or manual command execution.
Manage Daytona sandboxes for isolated evals, smoke tests, and command execution.
Generate sandbox-scoped task prompts for any LLM or tool runner working inside Daytona sandboxes.
Use for reusable Daytona sandbox workflows, SSH access, git setup, and isolated command execution.
| name | sandbox-troubleshooting |
| description | Troubleshoot Daytona sandbox runs, SSH access, snapshots, credentials, and command execution failures. |
| Symptom | Likely Cause | Fix |
|---|---|---|
exec returns -1 | Daytona SDK issue on snapshots | Use SSH-backed ralph-town run |
| Command not found over SSH | PATH is limited | Use full paths or export PATH |
| GitHub auth fails in sandbox | Wrong token context or missing env | Use SANDBOX_GH_TOKEN, forwarded as GH_TOKEN |
| Model API auth fails in sandbox | Local key was not intentionally forwarded | Use SANDBOX_ANTHROPIC_API_KEY |
| Snapshot command lacks tools | Snapshot is stale or missing packages | Run sandbox preflight, rebuild if needed |
| Sandbox costs keep rising | Kept sandbox not deleted | ralph-town sandbox list, then delete |
For simple evals and smoke tests:
ralph-town run --json -- pnpx my-pi@latest --help
Use --keep only when you need to debug interactively.
| Tool | Full Path |
|---|---|
| git | /usr/bin/git |
| gh | /usr/bin/gh |
| pnpm | /usr/local/bin/pnpm |
| curl | /usr/bin/curl |
Use nopeek locally:
pnpx nopeek audit
pnpx nopeek load .env --only DAYTONA_API_KEY,SANDBOX_GH_TOKEN,SANDBOX_ANTHROPIC_API_KEY
Do not echo token values.
ralph-town sandbox preflight
ralph-town sandbox preflight --snapshot <name> --json
If preflight fails, recreate the snapshot:
ralph-town sandbox snapshot create --force