KernDocs
KernGitHub ↗

Operations

Troubleshooting

A symptom-first guide for deployment, agent, tool, and network failures.

A request cannot reach the internet

  1. 1
    Open Network audit

    Find the exact host, method, path, decision, and denial reason.

  2. 2
    Check the integration

    Confirm the managed integration or custom-domain rule exists and is enabled.

  3. 3
    Correct the smallest mismatch

    Fix the hostname, allowed method, path guard, repository scope, or credential state named by the denial.

  4. 4
    Retry 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.