Debugging - Charm Docs

Use this guide to troubleshoot common local and cloud execution issues.

Start with Validation

charm validate .

Fix manifest and entry point issues before debugging runtime behavior.

charm run . --input "Hello" --debug

Check runtime.adapter.entry_point and make sure the module/object exists.

Declare required keys in charm.yaml and provide local values in .env.

Reduce long-running work or move persistent behavior to daemon lifecycle.

Avoid loading large local models or large datasets into memory.

Run Docker sandbox mode:

charm run . --input "Hello" --docker

Then check cloud logs:

charm logs --path .

If you are blocked, open an issue or ask in Discord with validation output, logs, and reproduction steps.