mirror of
https://github.com/fabro-sh/fabro.git
synced 2026-10-06 02:48:25 +00:00
d002aa0b51
* arc(01KK7524KNGTPS4090QMF87FJN): implement (success) Arc-Run: 01KK7524KNGTPS4090QMF87FJN Arc-Completed: 2 Arc-Checkpoint: 1ff03c704805dfe8e7c37b37f97bd06dfa0e5dc5 * Fix: restore trailing newlines stripped by previous commit * arc(01KK7524KNGTPS4090QMF87FJN): simplify (success) Arc-Run: 01KK7524KNGTPS4090QMF87FJN Arc-Completed: 3 Arc-Checkpoint: 21771adfd26283a1d1e6b8a123a83a0c4277db48 --------- Co-authored-by: arc <arc@local> Co-authored-by: Arc Assistant <assistant@arc.dev> Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
39 lines
1.8 KiB
Text
39 lines
1.8 KiB
Text
---
|
|
title: "Troubleshooting"
|
|
description: "Diagnosing and resolving common issues with Arc"
|
|
---
|
|
|
|
## `arc doctor`
|
|
|
|
The `arc doctor` command validates your installation:
|
|
|
|
```bash
|
|
arc doctor # Check local configuration
|
|
arc doctor --live # Also probe live services (LLM APIs, sandbox, Brave Search)
|
|
arc doctor --verbose # Show detailed output for each check
|
|
```
|
|
|
|
It checks:
|
|
- System dependencies (`openssl`, `node`, `gh`, `dot`)
|
|
- LLM provider API keys
|
|
- Sandbox availability (Docker daemon, Daytona API key)
|
|
- JWT key configuration
|
|
- Brave Search API key
|
|
|
|
## Common issues
|
|
|
|
**"No API key configured"** — Set at least one provider key in `.env` or your shell environment. Run `arc doctor --live` to verify connectivity.
|
|
|
|
**Stall watchdog timeouts** — If runs are cancelled unexpectedly, the agent may be stuck or the LLM provider may be slow. Check `ARC_LOG=debug` output for `Agent.LlmRetry` events. Increase `stall_timeout` in the graph if needed, or add [fallback providers](/core-concepts/models) to handle outages.
|
|
|
|
**Sandbox creation failures** — For Docker: ensure the Docker daemon is running and the configured image exists. For Daytona: verify `DAYTONA_API_KEY` is set and the `gh` CLI is authenticated. For Exe: verify your SSH keys are configured for `exe.dev` and that `ssh exe.dev` connects successfully.
|
|
|
|
**Port already in use** — Change the port with `arc serve --port 3001` or stop the conflicting process.
|
|
|
|
**SSE streams disconnecting** — If using a reverse proxy, ensure buffering is disabled and the connection timeout is long enough for workflow runs. See the [reverse proxy example](/administration/deployment#binding-and-tls).
|
|
|
|
**Run config validation errors** — Use `--preflight` to validate without executing:
|
|
|
|
```bash
|
|
arc run run.toml --preflight
|
|
```
|