Download and Install

The standard TDengine server package includes taosd, taosAdapter, taosc, the taos shell, taosdump, taosBenchmark, TDinsight installation scripts, and example code. A Lite package is also available when you only need the server and C/C++ client support.

TDengine provides Deb and RPM packages for Linux, a generic tar.gz package, an apt-get repository, a Windows client installer, and macOS packages.

Requirements

The minimum Linux runtime requirements are:

1. Linux kernel 3.10.0-1160.83.1.el7.x86_64 or later.
2. GLIBC 2.17 or later on x64, or 2.27 or later on ARM.

Building from source additionally requires CMake 3.26.4 or later and GCC 9.3.1 or later.

Install

note

• Starting with TDengine v3.0.6.0, taosTools is no longer distributed separately. Its tools are included in the TDengine server package.
• When installing the first node, leave the Enter FQDN: prompt empty. For later nodes, enter the FQDN of any available node in the existing cluster, or configure it before starting the new node.

tar.gz

1. Download the generic Linux package:

2. Extract and install it:

   tar -zxvf tdengine-tsdb-oss-{{VERSION}}-linux-x64.tar.gz
   sudo ./install.sh

Use ./install.sh -e no for a non-interactive installation, or ./install.sh -h to list all options.

Deb

1. Download the Ubuntu package:

2. Install it:

   sudo dpkg -i tdengine-tsdb-oss-{{VERSION}}-linux-x64.deb

RPM

1. Download the Red Hat package:

2. Install it:

   sudo rpm -ivh tdengine-tsdb-oss-{{VERSION}}-linux-x64.rpm

apt-get

Configure the stable package repository and install TDengine:

wget -qO - http://repos.taosdata.com/tdengine.key | sudo apt-key add -
echo "deb [arch=amd64] http://repos.taosdata.com/tdengine-stable stable main" | sudo tee /etc/apt/sources.list.d/tdengine-stable.list
sudo apt-get update
apt-cache policy tdengine-tsdb
sudo apt-get install tdengine-tsdb

For beta packages, replace the repository line with:

echo "deb [arch=amd64] http://repos.taosdata.com/tdengine-beta beta main" | sudo tee /etc/apt/sources.list.d/tdengine-beta.list

This installation method supports Debian and Ubuntu only.

Windows

1. Download the Windows client installer:
2. Run the installer.

Starting with TDengine v3.1.0.0, only the Windows client package is available for the Community Edition. The installer requires Microsoft Visual C++ Redistributable 2015-2022 x64 14.44 or later and can install its bundled runtime when necessary.

macOS

1. Download the macOS package:
2. Run the installer. If macOS blocks it, Control-click the package and select Open.

Start Services

Linux

Start the installed services with systemctl:

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

You can also run start-all.sh. Use systemctl stop, restart, or status to manage an individual service. If systemd is unavailable, run /usr/local/taos/bin/taosd directly.

Windows

In an administrator Command Prompt, run sc start taosd. To provide HTTP/REST services, also run sc start taosadapter.

macOS

Use launchctl or start-all.sh:

sudo launchctl start com.tdengine.taosd
sudo launchctl start com.tdengine.taosadapter
sudo launchctl start com.tdengine.taoskeeper
sudo launchctl start com.tdengine.taos-explorer

Customize taosd Startup with a systemd Drop-in

Use a drop-in file to preserve custom startup settings across upgrades. This example changes the startup retry accounting window to 60 seconds:

sudo mkdir -p /etc/systemd/system/taosd.service.d
sudo tee /etc/systemd/system/taosd.service.d/60-retry.conf >/dev/null <<'EOF'
[Service]
StartLimitInterval=60s
EOF
sudo systemctl daemon-reload
sudo systemctl restart taosd

The drop-in only needs to contain overridden or additional fields.

Installation Layout

The default Linux installation creates the following paths:

Path	Purpose
/usr/local/taos/bin	TDengine executables
/usr/local/taos/driver	Dynamic libraries
/usr/local/taos/examples	Connector examples
/usr/local/taos/include	Public C headers
/etc/taos/taos.cfg	Default configuration file
/var/lib/taos	Default data directory
/var/log/taos	Default log directory

The executables include taosd, taos, taosdump, taosBenchmark, taosadapter, and maintenance scripts such as remove.sh and set_core.sh.

For IPv4 and IPv6 configuration, see Network and FQDN Configuration.