# Troubleshooting Chainguard Containers

URL: https://deploy-preview-3996--ornate-narwhal-088216.netlify.app/chainguard/containers/troubleshooting.md

Resources on how to troubleshoot issues that may come up when using Chainguard Containers.

## Pages

- [Troubleshoot container and version availability](https://deploy-preview-3996--ornate-narwhal-088216.netlify.app/chainguard/containers/troubleshooting/container-version-troubleshooting.md): When a container or version isn't available to you: how to identify which situation you're in, what to do about each, and when to open a support request.
- [Troubleshoot registry authentication errors](https://deploy-preview-3996--ornate-narwhal-088216.netlify.app/chainguard/containers/troubleshooting/registry-errors.md): Map the errors cgr.dev returns during login and pull to their causes, including why the same HTTP status code means different things at the token endpoint and the registry API.
- [Inspecting Chainguard Containers](https://deploy-preview-3996--ornate-narwhal-088216.netlify.app/chainguard/containers/troubleshooting/inspecting-containers.md): How to identify exactly which container build you have with a digest, and how to read the software versions inside it from the container's SBOM
- [Debugging distroless container images](https://deploy-preview-3996--ornate-narwhal-088216.netlify.app/chainguard/containers/troubleshooting/debugging-distroless-images.md): In this article, we'll discuss a few different strategies to debug distroless images, considering these images typically don't include a shell or package managers.