Container Usage (Docker & OCI)

Official multi-architecture OCI container images are published on every release to both Docker Hub and GitHub Container Registry (GHCR):

Quickstart

Validate contracts in the current working directory without installing host binaries:

# Via Docker Hub (short alias)
docker run --rm -v $(pwd):/contracts:ro kmnsio/validate:latest run /contracts/validate.yaml

# Via GitHub Packages (GHCR)
docker run --rm -v $(pwd):/contracts:ro ghcr.io/kmns-io/kmns-validate:latest run /contracts/validate.yaml

Comprehensive Host Infrastructure Validation

Validate host UNIX sockets, Docker/Podman engines, and systemd services from within a container by mounting runtime sockets:

docker run --rm \
  --net=host \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /run/systemd/system:/run/systemd/system:ro \
  -v $(pwd)/validate.yaml:/etc/kmns/validate.yaml:ro \
  kmnsio/validate:latest run /etc/kmns/validate.yaml

Image Tags & Architectures