docker-compose.yml

# IRIS for Health Community Edition -- the learning sandbox.
#
# NOTE the image name. `intersystems/iris-community` is plain IRIS and does NOT
# ship EnsLib.HL7 or the HL7 v2 schema library. Only the *for Health* image does.
# Picking the wrong one here is the classic way to lose an afternoon.
#
# Community Edition is licensed for development and learning only.

services:
  iris:
    image: intersystems/irishealth-community:latest-em
    container_name: iris-lab
    ports:
      # Host 42773, not 52773. Windows/Hyper-V reserves 52689-52788 for dynamic
      # ports, so binding the obvious one fails with "access permissions" long
      # before IRIS gets a chance to start. Check yours with:
      #   netsh int ipv4 show excludedportrange protocol=tcp
      - "42773:52773"   # Management Portal / CSP
      - "1972:1972"     # superserver (VS Code ObjectScript, JDBC)
    volumes:
      - ./lab:/lab      # your editable message + transform + output
      - ./src:/src      # the harness class, reloaded on every run
    # Deliberately NO durable %SYS volume. IRIS runs as uid 51773 (irisowner) and
    # a fresh named volume is owned by root, so IRIS fails at boot with
    # "Cannot create target: /durable/iris/". Fixing that needs a chown init
    # step, which is a lot of machinery to persist a sandbox that should be
    # disposable. Everything you care about lives in ./lab and ./src on the host;
    # `docker compose down && up -d` gives you a clean instance in seconds.
    restart: unless-stopped