Charon/docs/debugging-local-container.md

Debugging the Local Docker Image

Use the cpmp:local image as the source of truth and attach VS Code debuggers directly to the running container.

1. Enable the debugger

The image now ships with the Delve debugger. When you start the container, set CPMP_DEBUG=1 (and optionally CPMP_DEBUG_PORT) so CPM+ runs under Delve.

docker run --rm -it \
  --name cpmp-debug \
  -p 8080:8080 \
  -p 2345:2345 \
  -e CPM_ENV=development \
  -e CPM_DEBUG=1 \
  cpmp:local

Delve will listen on localhost:2345, while the UI remains available at http://localhost:8080.

2. Attach VS Code

• Use the Attach to CPMP backend configuration in .vscode/launch.json to connect the Go debugger to Delve.
• Use the Open CPMP frontend configuration to launch Chrome against the management UI.

These launch configurations assume the ports above are exposed. If you need a different port, set CPMP_DEBUG_PORT when running the container and update the Go configuration's port field accordingly.