Skip to main content

Quick Install from Package

This document describes how to install TDengine on Linux/Windows/macOS and perform queries and inserts.

The full package of TDengine includes the TDengine Server (taosd), TDengine Client (taosc), taosAdapter for connecting with third-party systems and providing a RESTful interface, a command-line interface (CLI, taos), and some tools. Note that taosAdapter supports Linux only. In addition to client libraries for multiple languages, TDengine also provides a REST API through taosAdapter.

The standard server installation package includes taos, taosd, taosAdapter, taosBenchmark, and sample code. You can also download the Lite package that includes only taosd and the C/C++ client library.

TDengine OSS is released as Deb and RPM packages. The Deb package can be installed on Debian, Ubuntu, and derivative systems. The RPM package can be installed on CentOS, RHEL, SUSE, and derivative systems. A .tar.gz package is also provided for enterprise customers, and you can install TDengine over apt-get as well. The package includes taosdump and the TDinsight installation script. If you want to use these utilities with the Deb or RPM package, download and install taosTools separately. TDengine can also be installed on x64 Windows and x64/m1 macOS.

Operating environment requirements

In the Linux system, the minimum requirements for the operating environment are as follows:

linux core version - 3.10.0-1160.83.1.el7.x86_64;

glibc version - 2.17;

If compiling and installing through clone source code, it is also necessary to meet the following requirements:

cmake version - 3.26.4 or above;

gcc version - 9.3.1 or above;



Since TDengine, we don't provide standalone taosTools pacakge for downloading. However, all the tools included in the taosTools pacakge can be found in TDengine-server pacakge.

  1. Download the Deb installation package.
    • In the directory where the package is located, use dpkg to install the package:

    Please replace <version> with the corresponding version of the package downloaded

    sudo dpkg -i TDengine-server-<version>-Linux-x64.deb

    For information about TDengine other releases, check Release History.


    On the first node in your TDengine cluster, leave the Enter FQDN: prompt blank and press Enter. On subsequent nodes, you can enter the endpoint of the first dnode in the cluster. You can also configure this setting after you have finished installing TDengine.

    Quick Launch

    After the installation is complete, run the following command to start the TDengine service:

    systemctl start taosd
    systemctl start taosadapter
    systemctl start taoskeeper
    systemctl start taos-explorer

    Or you can run a scrip to start all the above services together 

    systemctl can also be used to stop, restart a specific service or check its status, like below using taosd as example:

    systemctl start taosd
    systemctl stop taosd
    systemctl restart taosd
    systemctl status taosd
    • The systemctl command requires root privileges. If you are not logged in as the root user, use the sudo command.
    • The systemctl stop taosd command does not instantly stop TDengine Server. The server is stopped only after all data in memory is flushed to disk. The time required depends on the cache size.
    • If your system does not include systemd, you can run /usr/local/taos/bin/taosd to start TDengine manually.

    TDengine Command Line Interface

    You can use the TDengine CLI to monitor your TDengine deployment and execute ad hoc queries. To open the CLI, you can execute taos (Linux/Mac) or taos.exe (Windows) in terminal. The prompt of TDengine CLI is like below:


    Using TDengine CLI, you can create and delete databases and tables and run all types of queries. Each SQL command must be end with a semicolon (;). For example:

    USE demo;
    INSERT INTO t VALUES ('2019-07-15 00:00:00', 10);
    INSERT INTO t VALUES ('2019-07-15 01:00:00', 20);
    SELECT * FROM t;

    ts | speed |
    2019-07-15 00:00:00.000 | 10 |
    2019-07-15 01:00:00.000 | 20 |

    Query OK, 2 row(s) in set (0.003128s)

    You can also can monitor the deployment status, add and remove user accounts, and manage running instances. You can run the TDengine CLI on either machines. For more information, see TDengine CLI.

    TDengine Graphic User Interface

    From TDengine, there is a new componenet called taos-explorer added in the TDengine docker image. You can use it to manage the databases, super tables, child tables, and data in your TDengine system. There are also some features only available in TDengine Enterprise Edition, please contact TDengine sales team in case you need these features.

    To use taos-explorer in the container, you need to access the host port mapped from container port 6060. Assuming the host name is, and the port used on host is 6060, you need to access taos-explorer uses port 6060 by default in the container. When you use it the first time, you need to register with your enterprise email, then can logon using your user name and password in the TDengine

    Test data insert performance

    After your TDengine Server is running normally, you can run the taosBenchmark utility to test its performance:

    Start TDengine service and execute taosBenchmark (formerly named taosdemo) in a terminal.


    This command creates the meters supertable in the test database. In the meters supertable, it then creates 10,000 subtables named d0 to d9999. Each table has 10,000 rows and each row has four columns: ts, current, voltage, and phase. The timestamps of the data in these columns range from 2017-07-14 10:40:00 000 to 2017-07-14 10:40:09 999. Each table is randomly assigned a groupId tag from 1 to 10 and a location tag of either California.Campbell, California.Cupertino, California.LosAngeles, California.MountainView, California.PaloAlto, California.SanDiego, California.SanFrancisco, California.SanJose, California.SantaClara or California.Sunnyvale.

    The taosBenchmark command creates a deployment with 100 million data points that you can use for testing purposes. The time required to create the deployment depends on your hardware. On most modern servers, the deployment is created in ten to twenty seconds.

    You can customize the test deployment that taosBenchmark creates by specifying command-line parameters. For information about command-line parameters, run the taosBenchmark --help command. For more information about taosBenchmark, see taosBenchmark.

    Test data query performance

    After using taosBenchmark to create your test deployment, you can run queries in the TDengine CLI to test its performance:

    From the TDengine CLI (taos) query the number of rows in the meters supertable:

    SELECT COUNT(*) FROM test.meters;

    Query the average, maximum, and minimum values of all 100 million rows of data:

    SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters;

    Query the number of rows whose location tag is California.SanFrancisco:

    SELECT COUNT(*) FROM test.meters WHERE location = "California.SanFrancisco";

    Query the average, maximum, and minimum values of all rows whose groupId tag is 10:

    SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters WHERE groupId = 10;

    Query the average, maximum, and minimum values for table d10 in 10 second intervals:

    SELECT FIRST(ts), AVG(current), MAX(voltage), MIN(phase) FROM test.d10 INTERVAL(10s);

    In the query above you are selecting the first timestamp (ts) in the interval, another way of selecting this would be \_wstart which will give the start of the time window. For more information about windowed queries, see Time-Series Extensions.