The ticloud command line tool brings deploy cluster requests, and other TiDB Cloud concepts to your fingertips.

• TiDB Cloud CLI
  • Table of Contents
  • Installation
    • macOS and Linux
      • Installing via script
      • Installing via TiUP
    • Manually
    • GitHub Action
  • Quick Start
    • Config a profile
    • Create a cluster
  • Documentation
  • Telemetry
  • Roadmap

curl https://raw.githubusercontent.com/tidbcloud/tidbcloud-cli/main/install.sh | sh

tiup install cloud

Download the pre-compiled binaries from the releases page and copy to the desired location.

To set up ticloud in GitHub Action, use setup-tidbcloud-cli.

In order to use the ticloud CLI, you need to have a TiDB Cloud account. If you don't have one, you can sign up for a free trial here.

Config a profile with your TiDB Cloud API key or log in via OAuth.

ticloud config create

# via TiUP
tiup cloud config create

# via OAuth
ticloud auth login

ℹ️ The config name MUST NOT contain '.'

ticloud serverless create

# via TiUP
tiup cloud serverless create

Please check the CLI help for more information.

See here

There are many features we want to add to the CLI.

• CLI supports generating demo code for using TiDB Cloud cluster.
• CLI supports managing the dedicated cluster.
• CLI supports backing up and restoring the TiDB Cloud cluster.
• CLI supports importing/exporting to external cloud storages.