Install with Docker
CloudDM single-node mode (Alone) runs the web console, data access services, and an embedded metadata database in one container. It is suitable for evaluation, small-scale use, and single-node self-hosting.
You can install CloudDM with Docker Run or Docker Compose. Both methods support the same features with either image. Choose the registry that your deployment host can reach.
Prerequisites
- Use a host with an
x86_64/amd64orarm64architecture. - Install Docker Engine. For the Compose method, install Docker Compose v2 as well.
- Make sure port
8222is available and allowed by your firewall or cloud security group. - Check that the host has no container named
cgdm-alone.
Start with Docker Run
Docker Hub image
docker run -d --name cgdm-alone \
--restart always \
-p 8222:8222 \
-v cgdm_alone_conf:/root/cgdm/alone/conf \
-v cgdm_alone_logs:/root/cgdm/alone/logs \
-v cgdm_alone_data:/root/cgdm/alone/data \
-v cgdm_mysql_data:/var/lib/mysql \
bladepipe/cgdm-alone:latest
China registry image
docker run -d --name cgdm-alone \
--restart always \
-p 8222:8222 \
-v cgdm_alone_conf:/root/cgdm/alone/conf \
-v cgdm_alone_logs:/root/cgdm/alone/logs \
-v cgdm_alone_data:/root/cgdm/alone/data \
-v cgdm_mysql_data:/var/lib/mysql \
cloudcanal-registry.cn-shanghai.cr.aliyuncs.com/clougence/cgdm-alone:latest
Start with Docker Compose
Docker Hub image
services:
dm_alone:
image: bladepipe/cgdm-alone:latest
container_name: cgdm-alone
restart: always
ports:
- "8222:8222"
volumes:
- cgdm_alone_conf:/root/cgdm/alone/conf
- cgdm_alone_logs:/root/cgdm/alone/logs
- cgdm_alone_data:/root/cgdm/alone/data
- cgdm_mysql_data:/var/lib/mysql
volumes:
cgdm_alone_conf:
cgdm_alone_logs:
cgdm_alone_data:
cgdm_mysql_data:
China registry image
services:
dm_alone:
image: cloudcanal-registry.cn-shanghai.cr.aliyuncs.com/clougence/cgdm-alone:latest
container_name: cgdm-alone
restart: always
ports:
- "8222:8222"
volumes:
- cgdm_alone_conf:/root/cgdm/alone/conf
- cgdm_alone_logs:/root/cgdm/alone/logs
- cgdm_alone_data:/root/cgdm/alone/data
- cgdm_mysql_data:/var/lib/mysql
volumes:
cgdm_alone_conf:
cgdm_alone_logs:
cgdm_alone_data:
cgdm_mysql_data:
Start the container
docker compose up -d
Environment variables
| Environment variable | Default | Description |
|---|---|---|
APP_WEB_PORT | 8222 | Web service port. If you change it, update the container port mapping to match. |
APP_WEB_JWT | Value built into the image | JWT signing key for web sign-in. |
APP_SERVE_NAME | 127.0.0.1 | Address of the internal CloudDM service. |
APP_SERVE_PORT | 8008 | Port of the internal CloudDM service. |
MYSQL_EMBEDDED | true | Enables embedded MySQL. Set to false when using an external MySQL database. |
MYSQL_ROOT_PASSWORD | 123456 | Root password for embedded MySQL. |
MYSQL_DATADIR | /var/lib/mysql | Data directory for embedded MySQL. |
MYSQL_SOCKET | /run/mysqld/mysqld.sock | Socket file path for embedded MySQL. |
MYSQL_PID_FILE | /run/mysqld/mysqld.pid | PID file path for embedded MySQL. |
MYSQL_INIT_MARKER | $MYSQL_DATADIR/.clouddm_mysql_initialized | Initialization marker file path for embedded MySQL. |
DB_HOST | 127.0.0.1 | Metadata database host. |
DB_PORT | 3306 | Metadata database port. |
DB_DATABASE | cdmgr | Metadata database name. |
DB_USERNAME | root | Metadata database username. |
DB_PASSWORD | Same as MYSQL_ROOT_PASSWORD | Metadata database password. |
WAIT_DB_TIMEOUT_SECONDS | 120 | Seconds to wait for the metadata database to become ready. |
WAIT_MYSQL_STOP_SECONDS | 30 | Seconds to wait for embedded MySQL to stop. |
info
All environment variables are optional. With Docker Run, set a variable at startup with -e NAME=value. With Docker Compose, set variables under environment.