Troubleshooting on

Troubleshoot a wrapped container

Tue, 06 Oct 2026 17:41:00 +0000

Note: Guarded Entrypoint is in beta. To use it, contact Chainguard customer support to enable it for your organization.

This page covers two kinds of problems. A container that is built with Guarded Entrypoint can fail to start. A build can also fail because Chainguard refuses to wrap an image.

First move: set GUARDED_DISABLE

When a wrapped container fails to start, set the GUARDED_DISABLE environment variable on the container and redeploy. The wrapper then starts the image’s original entrypoint and arguments without doing anything else. You don’t need to rebuild the image.

Troubleshooting melange builds

Wed, 10 Aug 2022 11:07:52 +0200

Debug options

To include debug-level information on melange builds, edit your melange.yaml file and include set -x in your pipeline. You can add this flag at any point of your pipeline commands to further debug a specific section of your build.

Troubleshooting apko builds

Wed, 10 Aug 2022 11:07:52 +0200

Debug options

To include debug-level information on apko builds, add --debug to your build command:

Troubleshoot Chainguard Checks

Thu, 08 Oct 2026 00:00:00 +0000

This page describes common problems with Chainguard Checks and how to fix them. If your problem isn’t listed here, ask in the #checks-questions channel in the Chainguard community Slack.

A pull request gets no checks

If a pull request shows no Chainguard Checks (presubmit) check at all, Chainguard Checks didn’t start a run for it. Confirm the following:

Troubleshoot Chainguard Workspaces

Thu, 08 Oct 2026 00:00:00 +0000

This page describes common problems with Chainguard Workspaces sessions and how to fix them. If your problem isn’t listed here, ask in the #workspaces-questions channel in the Chainguard community Slack.

chainctl doesn’t list the develop command

During the beta, the chainctl checks and chainctl develop commands don’t appear in chainctl --help or in the chainctl reference. You can still run them, and --help on either one shows its full help.