Skip to main content

14.13.3 TDengine All-in-One Docker Deployment

This guide explains how to deploy TDengine All-in-One using Docker.

Docker deployment supports Linux, Windows, and macOS. macOS supports Docker deployment only.

14.13.3.1 Environment Requirements

Before deployment, ensure that the platform meets the following requirements.

PlatformRequirement
LinuxDocker Engine 20.10 or later
WindowsDocker Engine or Docker Desktop
macOSDocker Desktop

The host also requires stable internet access. Windows requires administrator privileges, and Linux requires root privileges.

Recommended configuration:

ResourceRecommended
CPU12 cores
Memory16 GB RAM
Storage100 GB available disk space

14.13.3.2 Prepare Docker

Confirm that Docker is installed and running.

Check the Docker version:

docker version

Check the Docker service:

docker info

14.13.3.3 Run the Docker Deployment

Linux

Run the following command as root:

curl -fsSL https://downloads.taosdata.com/apex/install.sh | bash -s -- -m docker

macOS

Open a terminal and run:

curl -fsSL https://downloads.taosdata.com/apex/install.sh | bash -s -- -m docker

Docker Desktop must be running before you start deployment.

Windows

Open PowerShell as Administrator and run:

iwr https://downloads.taosdata.com/apex/install.ps1 -UseBasicParsing -OutFile $env:TEMP\apex-install.ps1; & $env:TEMP\apex-install.ps1 -Mode docker

When the deployment prompt appears, press Enter to continue the installation.

14.13.3.4 Access and Activate IDMP

After deployment completes successfully, open IDMP in a browser:

http://localhost:6042

If you access the service from another machine, replace localhost with the host name or IP address of the server where TDengine is installed.

Enter your email address, organization name, and verification code to activate IDMP.

IDMP activation page

For the Free Edition, review the license agreement and select Agree and Activate Free License.

TDengine Free Edition license activation