下载安装

TDengine 完整的软件包包括服务端（taosd）、应用驱动（taosc）、用于与第三方系统对接并提供 RESTful 接口的 taosAdapter、命令行程序 taos 和一些工具软件。目前 TDinsight 仅在 Linux 系统上安装和运行，后续将支持 Windows、macOS 等系统。TDengine 除了提供多种语言的连接器之外，还通过 taosAdapter 提供 RESTful 接口。

为方便使用，标准的服务端安装包包含了 taosd、taosAdapter、taosc、taos、taosdump、taosBenchmark、TDinsight 安装脚本和示例代码；如果你只需要用到服务端程序和客户端连接的 C/C++ 语言支持，也可以仅下载 Lite 版本的安装包。

在 Linux 系统上，TDengine 社区版提供 Deb 和 RPM 格式安装包，其中 Deb 支持 Debian/Ubuntu 及其衍生系统，RPM 支持 CentOS/RHEL/SUSE 及其衍生系统，用户可以根据自己的运行环境自行选择。同时我们也提供了 tar.gz 格式安装包，以及 apt-get 工具从线上进行安装。

此外，TDengine 也提供 macOS x64/m1 平台的 pkg 安装包。

下文安装步骤中的下载列表为**社区版（TDengine TSDB-OSS）**安装包。若需要企业版，请前往 TDengine 产品下载中心获取对应平台与版本的安装包。

环境要求

在 Linux 系统中，运行环境最低要求如下：

Linux 内核版本：3.10.0-1160.83.1.el7.x86_64 或以上
GLIBC 版本：2.17 及以上 (x64 架构)，2.27 及以上 (ARM 架构 )

如果通过源码编译安装，还需要满足：

cmake 版本：3.26.4 或以上
gcc 版本：9.3.1 或以上

安装

备注

从 TDengine 3.0.6.0 开始，不再提供单独的 taosTools 安装包，原 taosTools 安装包中包含的工具都在 TDengine 服务端安装包中，如果需要请直接下载 TDengine 服务端安装包。
当安装第一个节点时，出现 Enter FQDN: 提示的时候，不需要输入任何内容。只有当安装第二个或以后更多的节点时，才需要输入已有集群中任何一个可用节点的 FQDN，支持该新节点加入集群。当然也可以不输入，而是在新节点启动前，配置到新节点的配置文件中。

从列表中下载获得 tar.gz 安装包：
进入到安装包所在目录，使用 tar 解压安装包；
```
tar -zxvf tdengine-tsdb-oss-{{VERSION}}-linux-x64.tar.gz
```
进入到安装包所在目录，先解压文件后，进入子目录，执行其中的 install.sh 安装脚本。
```
sudo ./install.sh
```

信息

install.sh 安装脚本在执行过程中，会通过命令行交互界面询问一些配置信息。如果希望采取无交互安装方式，那么可以运行 ./install.sh -e no。运行 ./install.sh -h 指令可以查看所有参数的详细说明信息。

从列表中下载获得 deb 安装包：
进入到安装包所在目录，执行如下的安装命令：
```
sudo dpkg -i tdengine-tsdb-oss-{{VERSION}}-linux-x64.deb
```

从列表中下载获得 rpm 安装包：
进入到安装包所在目录，执行如下的安装命令：
```
sudo rpm -ivh tdengine-tsdb-oss-{{VERSION}}-linux-x64.rpm
```

可以使用 apt-get 工具从官方仓库安装。

配置包仓库

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

如果安装 Beta 版需要安装包仓库：

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

使用 `apt-get` 命令安装

sudo apt-get update
apt-cache policy tdengine-tsdb
sudo apt-get install tdengine-tsdb

提示

apt-get 方式只适用于 Debian 或 Ubuntu 系统。

从列表中下载获得最新 Windows 安装程序：
运行安装程序，根据提示完成 TDengine 的安装。默认安装目录为 C:\\TDengine。你可以选择安装根目录；如果所选路径未以 TDengine 结尾，安装程序会自动在其下创建 TDengine 目录。例如，选择 D:\\apps 后，实际安装目录为 D:\\apps\\TDengine；直接选择 D:\\apps\\TDengine 时，不会重复创建目录。升级安装会继续使用已有安装目录，不能更改该目录。

备注

从 TDengine 3.1.0.0 开始，只提供 Windows 客户端安装包。如果需要 Windows 服务端安装包，请联系 TDengine 销售团队升级为企业版。
目前 TDengine 在 Windows 平台上只支持 Windows Server 2016/2019 和 Windows 10/11。
Windows 安装程序会检测 Microsoft Visual C++ Redistributable 2015-2022 x64 14.44 或更高版本。如果运行库缺失或版本过低，确认提示后安装程序会自动安装内置的 14.50.35719.0 运行库。如果安装失败，可从 VC 运行时库下载最新支持版本后重试。

从列表中下载获得最新 macOS 安装包：
运行可执行程序来安装 TDengine。如果安装被阻止，可以右键或者按 Ctrl 点击安装包，选择 打开。

启动

Linux 系统
Windows 系统
macOS 系统

安装后，请使用 systemctl 命令来启动 TDengine 的服务进程。

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

你也可以直接运行 start-all.sh 脚本来启动上面的所有服务

start-all.sh

可以使用 systemctl 来单独管理上面的每一个服务

systemctl start taosd
systemctl stop taosd
systemctl restart taosd
systemctl status taosd

信息

systemctl 命令需要 root 权限来运行，如果你非 root 用户，请在命令前添加 sudo。
systemctl stop taosd 指令在执行后并不会马上停止 TDengine 服务，而是会等待系统中必要的落盘工作正常完成。在数据量很大的情况下，这可能会消耗较长时间。
如果系统中不支持 systemd，也可以用手动运行 /usr/local/taos/bin/taosd 方式启动 TDengine 服务。
如果希望自定义 TDengine 服务参数，则参考使用 Systemd drop-in 文件自定义 taosd 启动参数。

如果安装的是 Windows 服务端安装包，安装程序会将实际安装目录添加到 PATH 环境变量。安装完成后，以管理员身份重新打开 cmd 窗口，进入实际安装目录，然后执行以下命令来启动、查看或停止所有服务：

start-all.bat
start-all.bat status
start-all.bat stop

如果只需启动服务，并跳过连通性检查以及 Snode 和 Xnode 初始化，可以执行 start-all.bat -S。

安装后，在应用程序目录下，双击 TDengine 图标来启动程序，也可以运行 sudo launchctl start 来启动 TDengine 服务进程。

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

你也可以直接运行 start-all.sh 脚本来启动上面的所有服务

start-all.sh

可以使用 launchctl 命令管理上面提到的每个 TDengine 服务，以下示例使用 taosd：

sudo launchctl start com.tdengine.taosd
sudo launchctl stop com.tdengine.taosd
sudo launchctl list | grep taosd
sudo launchctl print system/com.tdengine.taosd

信息

launchctl 命令管理 com.tdengine.taosd 需要管理员权限，务必在前面加 sudo 来增强安全性。
sudo launchctl list | grep taosd 指令返回的第一列是 taosd 程序的 PID，若为 - 则说明 TDengine 服务未运行。
故障排查：
如果服务异常请查看系统日志 launchd.log 或者 /var/log/taos 目录下 taosdlog 日志获取更多信息。

使用 Systemd drop-in 文件自定义 taosd 启动参数

如果你希望调整 Linux 下 TDengine 服务的启动重试窗口等参数，我们推荐使用 Systemd drop-in 机制来定制服务启动参数，以避免在软件升级时被覆盖。下面以将 taosd 服务的启动重试统计窗口改为 60 秒为例，说明如何使用 drop-in 文件。

创建 drop-in 目录 drop-in 目录的路径为/etc/systemd/system/<unit-name>.service.d/（对于 taosd 服务，即为/etc/systemd/system/taosd.service.d/），用于存放 .conf 格式的覆盖配置文件。

sudo mkdir -p /etc/systemd/system/taosd.service.d

编写 override 文件（必须带段标题，文件名任意，以 .conf 结尾）

sudo tee /etc/systemd/system/taosd.service.d/60-retry.conf >/dev/null <<'EOF'
[Service]
# 将启动重试统计窗口改为 60 秒
StartLimitInterval=60s
EOF

重载并重启服务

sudo systemctl daemon-reload
sudo systemctl restart taosd

说明 override 文件仅需写入要改/新增的字段，其余沿用主服务文件。可同时存在多个 .conf 文件，按字典序加载。

获取历史版本

历史版本可以前往 TDengine 产品下载中心的 TDengine TSDB-Enterprise 页面。

目录结构

以 Linux 为例，安装 TDengine 后，默认会在操作系统中生成下列目录或文件：

目录/文件	说明
/usr/local/taos/bin	TDengine 可执行文件目录。其中的执行文件都会软链接到/usr/bin 目录下。
/usr/local/taos/driver	TDengine 动态链接库目录。会软链接到/usr/lib 目录下。
/usr/local/taos/examples	TDengine 各种语言应用示例目录。
/usr/local/taos/include	TDengine 对外提供的 C 语言接口的头文件。
/etc/taos/taos.cfg	TDengine 默认`配置文件`
/var/lib/taos	TDengine 默认数据文件目录。可通过`配置文件`修改位置。
/var/log/taos	TDengine 默认日志文件目录。可通过`配置文件`修改位置。

可执行程序

TDengine 的所有可执行文件默认存放在 /usr/local/taos/bin 目录下。其中包括：

taosd：TDengine 服务端可执行文件
taos：taos shell 可执行文件
taosdump：数据导入导出工具
taosBenchmark: TDengine 测试工具
remove.sh: 卸载 TDengine 的脚本，请谨慎执行，链接到/usr/bin 目录下的rmtaos命令。会删除 TDengine 的安装目录/usr/local/taos，但会保留/etc/taos、/var/lib/taos、/var/log/taos
taosadapter: 提供 RESTful 服务和接受其他多种软件写入请求的服务端可执行文件
TDinsight.sh: 用于下载 TDinsight 并安装的脚本
set_core.sh: 用于方便调试设置系统生成 core dump 文件的脚本
taosd-dump-cfg.gdb: 用于方便调试 taosd 的 gdb 执行脚本。