Skip to main content

14.3.1 Docker Deployment

This guide explains how to deploy TDengine IDMP with Docker / Docker Compose. The recommended approach is TDengine All-in-One, which installs TSDB, IDMP, and related components in one step.

For the complete All-in-One Docker deployment guide, see section 14.13.3.

14.3.1.1 Prerequisites​

14.3.1.2 Installation​

Follow the Docker command provided for TDengine All-in-One in the TDengine Download Center.

All-in-One Docker deployment automatically switches to https://tdengine-registry.cn-beijing.cr.aliyuncs.com to pull images and improve download speed. For detailed steps, registry mirror configuration, and troubleshooting, see section 14.13.3.

14.3.1.3 Start and Stop​

After All-in-One installation completes, IDMP and related services start automatically. You can also start and stop them manually.

Linux / macOS:

cd ~/.apex/docker
./tdengine.sh start
cd ~/.apex/docker
./tdengine.sh stop

Windows (Administrator PowerShell):

cd $env:USERPROFILE\.apex\docker
.\tdengine.ps1 start
cd $env:USERPROFILE\.apex\docker
.\tdengine.ps1 stop

When starting, you are prompted to select a deployment mode:

  • Standard — TDengine TSDB Enterprise + IDMP
  • Full — TDengine TSDB Enterprise + IDMP + TDgpt (time-series forecasting and anomaly detection)

The AI service is deployed as the independent image tdengine/idmp-ai-ee and is included automatically in the Docker Compose configuration. Required images are pulled automatically if they are not present locally.

By default, the TDengine IDMP service listens on the following host ports:

  • HTTP access: http://localhost:6042 or http://ip:6042
  • HTTPS access: https://localhost:6034 or https://ip:6034
tip
  • To change the port mapping, edit the ports settings in the Compose files under ~/.apex/docker.

  • To configure the base path for the gateway reverse proxy, you first need to explicitly specify this base path by setting the TDA_REST_BASE_PATH environment variable. Meanwhile, the gateway side needs to complete two configurations: 1. Configure the routing forwarding rule pointing to http://<target address>/idmp_config; 2. Configure the path rewriting rule to ensure that the aforementioned base path contained in the request URL is removed before forwarding the request to the backend service.

Do not delete the deployment directory generated by All-in-One. It may contain Docker Compose files, environment files, volume mappings, network configuration, component configuration, and upgrade or maintenance metadata.

14.3.1.4 Troubleshooting​

  1. The IDMP page displays AI service is unhealthy.

Open Admin Console → Connections, open the AI connection details, and check whether the built-in key has expired. If it has expired, set a valid key or create a new connection. If the issue remains unresolved, contact the TDengine team.