# Quick Start #### Run TiDB with Docker (Standalone mode) You can quickly test TiDB with Docker, the source repository contains the Dockerfile which contains local tidb-server. To install Docker on your system, you can read the document on https://docs.docker.com/ ``` docker pull pingcap/tidb:latest docker run --name tidb-server -d -p 4000:4000 pingcap/tidb:latest ``` `docker pull` may take a while to download images ~560M. Then you can use official mysql client to connect to TiDB. ``` mysql -h 127.0.0.1 -P 4000 -u root -D test --prompt="tidb> " ``` Notice: OS X user may use `docker-machine ip` to connect it. #### __Or run TiDB on TiKV cluster__ Read the documents for [Ansible deployment](https://pingcap.com/docs/stable/how-to/deploy/orchestrated/ansible/) or [Docker deployment](https://pingcap.com/docs/stable/how-to/deploy/orchestrated/docker/). #### __Pre-requirement__ Go environment. Currently a 64-bit version of go >= 1.9 is required. ``` git clone https://github.com/pingcap/tidb.git $GOPATH/src/github.com/pingcap/tidb cd $GOPATH/src/github.com/pingcap/tidb make ``` #### __Run as MySQL protocol server__ ``` make cd bin && ./tidb-server ``` In case you want to compile a specific location: ``` make server TARGET=$GOPATH/bin/tidb-server ``` The default server port is `4000` and can be changed by flag `-P `. Run `./tidb-server -h` to see more flag options. After you started tidb-server, you can use official `mysql` client to connect to TiDB. ``` mysql -h 127.0.0.1 -P 4000 -u root -D test --prompt="tidb> " ```