Important

You are viewing the archived documentation of TiDB, which no longer receives updates. It is recommended that you use the latest LTS version of the TiDB database.

Deploy a TiDB Cluster from Homebrew

TiDB on Homebrew supports a minimal installation mode of the tidb-server without the tikv-server or pd-server. This is useful for development environments, since you can test your application's compatibility with TiDB without needing to deploy a full TiDB platform.

This installation method is supported on macOS, Linux and Windows (via WSL).

Note

Internally this installation uses goleveldb as the storage engine. It is much slower than TiKV, and any benchmarks will be unreliable.

Installation steps

After first installing Homebrew, TiDB can be installed with:

brew tap pingcap/brew &&
brew install tidb-server

To start the tidb-server:

tidb-server

The tidb-server does not bundle any clients. To use with the MySQL client:

brew install mysql-client &&
mysql -h 127.0.0.1 -P4000 -uroot

Startup item

TiDB can start automatically on login. This is currently only supported on macOS:

brew services start tidb-server

Download PDF

Playground

New

One-stop & interactive experience of TiDB's capabilities WITHOUT registration.