Troubleshooting knowledge base

BaseHarbor keeps recurring runtime and acceptance failures in a versioned repository knowledge base.

Use this directory before starting a new Docker, Podman, TLS, identity, provider, or acceptance investigation.

Workflow

1. Search .github/known-failures.yaml for an error signature.
2. Open the matching incident document in docs/troubleshooting/incidents/.
3. Check the recorded root cause, fixes, related issues, and regression tests.
4. Verify whether the current branch already contains the documented fix.
5. Only start a new CI investigation when the failure is new or the documented fix is present and the failure still reproduces.

Incidents

• Podman Quadlet rootless storage context
• Podman local candidate image resolution
• Podman network alias scope
• Developer gateway effective port