Skip to content

How To Debug

Stefan Kuhn edited this page Jan 27, 2026 · 2 revisions

How to debug

Two common ways to get a shell inside the image:

1) Override the entrypoint

This starts a shell as root before the entrypoint runs.

aicage --entrypoint bash -- <agent>

You are in the image as root, with the entrypoint skipped.

2) Override the agent start command

This still runs the entrypoint, sets up the user, and drops you into a shell instead of starting an agent.

aicage -e AICAGE_ENTRYPOINT_CMD=bash -- <agent>

Clone this wiki locally