Files
deployment/README.docker.md
T
cedricveandCopilot 323b1ad300 docs: explain forthcoming Agent HTTP port migration
Preserve current port-80 deployment defaults and document coordinated image, Docker mapping, Kubernetes target and Factory compatibility updates.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 20:40:24 +00:00

1.4 KiB

Self-hosted with Docker Compose

....

Agent HTTP port migration

This Docker Compose guide is not yet complete. For Agent installation and configuration, see the Agent guide and Agent README.

Docker mappings use HOST_PORT:CONTAINER_PORT. Published Agent releases still listen on container port 80. With AGENT_IMAGE set to a verified tag or digest for one of those releases, expose the UI at http://localhost:8080 with:

docker run --name kerberos-agent -p 8080:80 \
  "${AGENT_IMAGE:?Set AGENT_IMAGE to a verified port-80 Agent image}"

The forthcoming hardened Agent image instead listens on container port 8080. Only after that image is available, set AGENT_IMAGE to its verified tag or digest and use:

docker run --name kerberos-agent -p 8080:8080 \
  "${AGENT_IMAGE:?Set AGENT_IMAGE to a verified port-8080 Agent image}"

These are alternative commands for a new container, not an in-place upgrade. Preserve your existing environment variables, mounts and recordings when recreating a container. In Compose, the equivalent ports entry changes from "8080:80" to "8080:8080" together with the image. Your chosen host port and browser URL need not change. Do not apply the new mapping to legacy images, or assume kerberos/agent:latest already includes the hardening update.