mirror of
https://github.com/harivansh-afk/sandbox-agent.git
synced 2026-04-15 14:03:52 +00:00
bf484e7c96
Delete orphaned docs not in docs.json navigation (gigacode.mdx, foundry-self-hosting.mdx, session-transcript-schema.mdx, pi-support-plan.md). Remove outdated musl/glibc troubleshooting section. Add event types documentation with example payloads to agent-sessions.mdx. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
57 lines
1.7 KiB
Text
57 lines
1.7 KiB
Text
---
|
|
title: "Troubleshooting"
|
|
description: "Common issues and solutions when running sandbox-agent"
|
|
---
|
|
|
|
## "Agent Process Exited" immediately after sending a message
|
|
|
|
This typically means the agent (Claude, Codex) crashed on startup. Common causes:
|
|
|
|
### 1. Network restrictions
|
|
|
|
The sandbox cannot reach the AI provider's API (`api.anthropic.com` or `api.openai.com`). Test connectivity with:
|
|
|
|
```bash
|
|
curl -s -o /dev/null -w '%{http_code}' --connect-timeout 5 https://api.anthropic.com/v1/messages
|
|
```
|
|
|
|
A `000` or timeout means the network is blocked. See [Daytona Network Restrictions](#daytona-network-restrictions) below.
|
|
|
|
### 2. Missing API key
|
|
|
|
Ensure `ANTHROPIC_API_KEY` or `OPENAI_API_KEY` is set in the sandbox environment, not just locally.
|
|
|
|
### 3. Agent binary not found
|
|
|
|
Verify the agent is installed:
|
|
|
|
```bash
|
|
ls -la ~/.local/share/sandbox-agent/bin/
|
|
```
|
|
|
|
|
|
## Daytona Network Restrictions
|
|
|
|
Daytona sandboxes have tier-based network access:
|
|
|
|
| Tier | Network Access |
|
|
|------|----------------|
|
|
| Tier 1 & 2 | Restricted. **Cannot be overridden.** AI provider APIs blocked by default. |
|
|
| Tier 3 & 4 | Full internet access. Custom allowlists supported. |
|
|
|
|
If you're on Tier 1/2 and agents fail immediately, you have two options:
|
|
|
|
1. **Upgrade to Tier 3+** for full network access
|
|
2. **Contact Daytona support** to whitelist `api.anthropic.com` and `api.openai.com` for your organization
|
|
|
|
The `networkAllowList` parameter only works on Tier 3+:
|
|
|
|
```typescript
|
|
await daytona.create({
|
|
snapshot: "my-snapshot",
|
|
envVars: { ANTHROPIC_API_KEY: "..." },
|
|
networkAllowList: "api.anthropic.com,api.openai.com", // Tier 3+ only
|
|
});
|
|
```
|
|
|
|
See [Daytona Network Limits documentation](https://www.daytona.io/docs/en/network-limits/) for details.
|