rayyounghong/perforce-helix-core repository overview

⁠docker-perforce-helix-core

docker-perforce-helix-core is a Docker image for running Perforce Helix Core Server. Multi-arch: linux/amd64, linux/arm64.

mkdir -p ./perforce
docker run -d --name p4d \
  -p 1666:1666 \
  -e P4PORT=1666 \
  -v "$(pwd)/perforce:/perforce" \
  rayyounghong/perforce-helix-core:latest

The container runs p4d as the non-root perforce user. On first start it initializes the database under P4ROOT and writes server.id if missing.

⁠Docker Compose

services:
  p4d:
    image: rayyounghong/perforce-helix-core:latest
    container_name: p4d
    ports:
      - "1666:1666"
    environment:
      - P4PORT=1666
    volumes:
      - ./perforce:/perforce
    restart: unless-stopped

⁠Environment variables

⁠Volumes

/perforce holds all server state (metadata/ and logs/). Mount it as a named volume or bind mount to persist data across container restarts.

⁠Healthcheck

The image ships a healthcheck that runs p4 -p localhost:$P4PORT info every 30 seconds. Use docker ps or docker inspect to see the health status.