---
title: TDengine Command Line (CLI)
sidebar_label: TDengine CLI
description: Instructions and tips for using the TDengine CLI to connect TDengine Cloud
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

The TDengine command-line application (hereafter referred to as `TDengine CLI`) is the most simplest way for users to manipulate and interact with TDengine instances.

## Installation

If executed on the TDengine server-side, there is no need for additional installation steps to install TDengine CLI as it is already included and installed automatically. To run TDengine CLI on the environment which no TDengine server running, the TDengine client installation package needs to be installed first. For details, please refer to [Install Client Driver](/reference/connector/#install-client-driver).

<Tabs defaultValue="ConfigOnLinux">
<TabItem value="ConfigOnLinux" label="Config on Linux">

Run this command in your Linux terminal to save your URL and token as variables:

```
export TDENGINE_CLOUD_URL=<URL>
export TDENGINE_CLOUD_TOKEN=<token>
```

</TabItem>
<TabItem value="ConfigOnWindows" label="Config on Windows (coming soon)">

Run this command in your Windows terminal to save your URL and token as variables:

```
set TDENGINE_CLOUD_URL=<URL>
set TDENGINE_CLOUD_TOKEN=<token>
```

</TabItem>
<TabItem value="ConfigOnMac" label="Config on Mac (coming soon)">

Run this command in your Mac terminal to save your URL and token as variables:

```
export TDENGINE_CLOUD_URL=<URL>
export TDENGINE_CLOUD_TOKEN=<token>
```

</TabItem>
</Tabs>

<Tabs defaultValue="ConnectOnLinux">
<TabItem value="ConnectOnLinux" label="Connect on Linux">

To access the TDengine Cloud, you can execute `taos -R -h $TDENGINE_CLOUD_URL -t $TDENGINE_CLOUD_TOKEN` command-line utility from a Linux terminal.

</TabItem>
<TabItem value="ConnectOnWindows" label="Connect on Windows (coming soon)">

To access the TDengine Cloud, you can execute `taos -R -h %TDENGINE_CLOUD_URL% -t %TDENGINE_CLOUD_TOKEN%` command-line utility from a Windows terminal.

</TabItem>
<TabItem value="ConnectOnMac" label="Connect on Mac (coming soon)">

To access the TDengine Cloud, you can execute `taos -R -h $TDENGINE_CLOUD_URL -t $TDENGINE_CLOUD_TOKEN` command-line utility from a Mac terminal.

</TabItem>
</Tabs>

## using TDengine CLI

TDengine CLI will display a welcome message and version information if it successfully connected to the TDengine service. If it fails, TDengine CLI will print an error message. See [FAQ](/train-faq/faq) to solve the problem of terminal connection failure to the server. The TDengine CLI prompts as follows:

```cmd
taos>
```

After entering the TDengine CLI, you can execute various SQL commands, including inserts, queries, or administrative commands. Please see the [official document](https://docs.tdengine.com/reference/taos-shell#execute-sql-script-file) for more details.