For the complete documentation index, see llms.txt.

Troubleshooting

Troubleshoot a wrapped container
How to recover a container that fails to start under Guarded Entrypoint, what the wrapper's exit codes mean, and how a refused build appears in chainctl.
Troubleshooting melange builds
Debugging and common errors with melange build
Troubleshooting apko builds
Debugging and common errors in apko
Troubleshoot Chainguard Checks
Fix common problems with Chainguard Checks, including pull requests that get no checks, refused configurations, failed runs, checks that couldn't run, network errors, missing tools, and unused caches.
Troubleshoot Chainguard Workspaces
Fix common problems with Chainguard Workspaces, including sign-up failures, permission errors, sessions that won't open, Claude Code errors, failed pushes, and usage limits.