Operations
Troubleshooting
A symptom-first guide for deployment, agent, tool, and network failures.
A request cannot reach the internet
- 1Open Network audit
Find the exact host, method, path, decision, and denial reason.
- 2Check the integration
Confirm the managed integration or custom-domain rule exists and is enabled.
- 3Correct the smallest mismatch
Fix the hostname, allowed method, path guard, repository scope, or credential state named by the denial.
- 4Retry once
Run the original request again and confirm the new decision in the audit.
A tool cannot run
- If the tool is bundled but disabled, enable it under Home → Integrations.
- If it needs OAuth, verify the intended account is connected and not expired.
- If the action returned an approval id, decide that exact approval and poll it. Do not submit a duplicate action.
- Use Tool audit to distinguish configuration, provider, approval, and execution failures.
The host is unreachable
- For SSH access, use the deployment's actual dynamic port and key.
- For a local UI, confirm the SSH forward is still running and open http://127.0.0.1:7443.
- For Cloudflare access, check the configured hostname, tunnel state, and service URL http://localhost:7443.
- On Kern Cloud, use the deployment status and operation history before retrying a lifecycle action.