Docker Args

Docker run pass-through args

aicage lets you pass extra docker run options straight to Docker. This is useful for things like extra env vars, port publishing, or attaching to a specific Docker network.

Syntax

Any arguments between aicage and the agent are treated as Docker args. You must separate them from the agent with --.

aicage [aicage options] <docker-args> -- <agent> [<agent-args>]

aicage does not validate these args; they are forwarded verbatim to docker run.

Proxy env vars

aicage automatically forwards these host proxy env vars to local image builds and runtime when they are set: HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, and NO_PROXY.

Examples

Set an environment variable inside the container (replace <agent> with your agent):

aicage -e FOO=bar -- <agent>

Publish a port:

aicage -p 3000:3000 -- <agent>

Attach to a network:

aicage --network my-net -- <agent>

Mount an extra directory (in addition to your project mount):

aicage -v ~/.cache:/home/aicage/.cache -- <agent>

Persistence

When you pass docker args, aicage asks whether to persist them for this project and agent. If you accept, they are stored in the project config and reused on future runs, so you only need to set them once.

To change or remove persisted args, pass new ones and accept the prompt, or edit the project config file directly (aicage --config info).