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: