Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
TiDB is built for agentic workloads that grow unpredictably, with ACID guarantees and native support for transactions, analytics, and vector search. No data silos. No noisy neighbors. No infrastructure ceiling.
Saved setup from 3 h ago
Will it work on macOS?
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install. The repo uses git submodules, so the clone fetches them too.
git clone --recurse-submodules https://github.com/pingcap/tidb.git cd tidb
Go 1.27.3
brew install go
go mod download
go test ./...
Start a TiDB cluster.
On local playground. To start a local test cluster, refer to the TiDB quick start guide.
On Kubernetes. TiDB can be easily deployed in a self-managed Kubernetes environment or Kubernetes services on public clouds using TiDB Operator. For more details, refer to the TiDB on Kubernetes quick start guide.
Using TiDB Cloud (recommended). TiDB Cloud offers a fully managed version of TiDB with a free plan, no credit card required, so you can get a free cluster in seconds and start easily: Sign up for TiDB Cloud.
Learn about TiDB SQL: To explore the SQL capabilities of TiDB, refer to the TiDB SQL documentation.
Use a MySQL driver or an ORM to Build an App with TiDB.
Explore key features, such as data migration, changefeed, vector search, HTAP, disaster recovery, etc.
No reports for macOS yet.
GitManual AI Agent reads the 12 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.