Installation

Register CDM with your identity provider first (Single Sign-On). Just looking? Try the Demo needs none.

Docker Compose

docker-compose.yml:

services:
  cdm:
    image: oci.croit.io/croit/cdm:latest
    container_name: cdm
    env_file: cdm.env
    ports:
      - "8234:8234"
    volumes:
      - cdm-data:/data
    restart: unless-stopped

volumes:
  cdm-data:
    name: cdm-data

cdm.env:

CDM_PUBLIC_URL=https://cdm.example.com
CDM_SECRET_KEY=<output of: openssl rand -hex 32>

OIDC_DISCOVERY_URL=https://id.example.com/application/o/cdm/.well-known/openid-configuration
OIDC_CLIENT_ID=cdm
OIDC_CLIENT_SECRET=<from your identity provider>
OIDC_ROLE_MAPPING={"storage-admins":"admin"}
docker compose up -d

In cdm.env, leave values unquoted. If you set them under environment: in docker-compose.yml instead, quote OIDC_ROLE_MAPPING, OIDC_DEFAULT_ROLES, CDM_DEMO_LOGIN and CDM_DEMO_CLUSTER.

All settings: Configuration Reference.

IMPORTANT

Back up CDM_SECRET_KEY. Without it, the stored cluster credentials cannot be decrypted.

docker run

docker run -d --name cdm -p 8234:8234 -v cdm-data:/data \
  -e CDM_PUBLIC_URL=https://cdm.example.com \
  -e CDM_SECRET_KEY=<output of: openssl rand -hex 32> \
  -e OIDC_DISCOVERY_URL=https://id.example.com/application/o/cdm/.well-known/openid-configuration \
  -e OIDC_CLIENT_ID=cdm \
  -e OIDC_CLIENT_SECRET=<from your identity provider> \
  -e OIDC_ROLE_MAPPING='{"storage-admins":"admin"}' \
  oci.croit.io/croit/cdm:latest

Host directory instead of a volume

CDM runs as UID 65532:

chown 65532:65532 /srv/cdm

Next steps

Sign in and accept the licence agreement as an admin, then add your clusters.