OpenHands Enterprise Troubleshooting

This skill helps diagnose and resolve common issues on OpenHands Enterprise (OHE) self-hosted installations using Replicated. It covers triage, guided recovery, support bundle generation, and escalation handoffs.

Diagnostic Workflow

When a user reports an OHE issue:

1. Collect symptoms - Ask user to describe what they see, error messages, when it started
2. Identify failure mode - Match symptoms to one of the common issues below
3. Run targeted diagnostics - Use commands in references/diagnostics.md
4. Guide recovery - Follow resolution steps for the identified issue, one at a time
5. Verify fix - Confirm the original symptom is gone, not just that the last command succeeded
6. Generate handoff - If unresolved, produce a clear summary for the OpenHands team