Option 1
Deploy TDengine Historian with Docker
Best for fast evaluations and guided setup. This path uses Docker Compose and packages the historian components together so the core services are connected automatically.
Specifications
- CPU: 8 cores
- Memory: 16 GB
- Disk: 50 GB free space
Prerequisites
- Install and run Docker Desktop.
- Download and unzip the deployment repository.
- Open a terminal in the
dockerdirectory within the deployment repo.
Deployment
- Standard
(without TDgpt):docker compose up -d - Full (with TDgpt):
docker compose -f docker-compose-tdgpt.yml up -d
Access after deployment
In a web browser, access TDengine Historian services:
- TDengine TSDB:
http://localhost:6060 - TDengine IDMP:
http://localhost:6042
Option 2
Install TDengine Historian locally
Best for direct deployment on Linux or Windows. In this path, you install TDengine TSDB-Enterprise first, then install TDengine IDMP, configure the connection, and start the services.
Specifications
- CPU: 8 cores
- Memory: 16 GB
- Disk: 50 GB free space
Download
Visit the TDengine Download Center and download the TDengine Historian installation package.
Note: Also download the TDgpt model resource package if your target machine does not have Internet access.
Installation
- Unzip the installation package and run
install.batas an administrator. - Once the installation has completed, run
start-services.batas an administrator.
Access after deployment
In a web browser, access TDengine Historian services:
- TDengine TSDB:
http://localhost:6060 - TDengine IDMP:
http://localhost:6042
Read the TDengine Historian installation manual for more details.
The video below shows the full installation procedure on Windows.
After installation
Next Steps
Activate TDengine Historian
Enter your email and organization, get the activation code, accept the agreement, and finish activation.
Create your account
Set your name, role, and password for the first administrator account.
Load a sample scenario
Choose one or more built-in sample scenarios to start exploring TDengine Historian quickly.
Explore the UI
Use the tour guide, review elements, try AI-generated panels, and test AI-powered analysis.
Licensing
Activate your TDengine License
Obtain License Code
Ready to Download TDengine Historian?
Choose the deployment path that fits your evaluation or environment and get started with the complete historian package.





