A Scalable, Survivable, Strongly-Consistent SQL Database
Go TypeScript JavaScript Protocol Buffer Yacc C++ Other
Latest commit 8b8376f Aug 30, 2016 @mjibson mjibson committed on GitHub Merge pull request #8756 from mjibson/copy
sql: support COPY protocol
Failed to load latest commit information.
.github Fix typo in issue template Apr 23, 2016
acceptance Merge pull request #8922 from cockroachdb/master Aug 29, 2016
base server/base: comment updates Aug 25, 2016
build Merge branch 'master' into develop Aug 30, 2016
cli Merge pull request #8922 from cockroachdb/master Aug 29, 2016
cloud docs: Copy Kubernetes config over from Kubernetes repo Aug 29, 2016
cmd Merge pull request #8840 from cockroachdb/master Aug 26, 2016
config config: convert ZoneConfig to the new format Aug 29, 2016
docs storage: stream snapshots via a new GRPC endpoint. Aug 24, 2016
githooks Remove githooks/pre-push. Sep 28, 2015
gossip Merge branch 'master' into develop Aug 30, 2016
internal Merge pull request #8752 from andreimatei/lease-reflection Aug 29, 2016
keys *: format maybe-nil errors as %v Aug 18, 2016
kv Merge branch 'master' into develop Aug 29, 2016
resource Remove old PDF logos Jun 8, 2016
roachpb roachpb: shallow copy `BatchRequest.Txn` when mutating Aug 29, 2016
rpc rpc: remove unnecessary member Aug 25, 2016
scripts scripts: allow varying Go version Aug 30, 2016
security Bump to go1.7rc3 Aug 3, 2016
server Merge branch 'master' into develop Aug 29, 2016
sql sql: support COPY protocol Aug 30, 2016
storage Merge branch 'master' into develop Aug 30, 2016
testutils storage: introduce LeaseInfoRequest Aug 29, 2016
ts time series: Rename a few objects Aug 28, 2016
ui Merge branch 'master' into develop Aug 29, 2016
util storage: clean up queue.ctx usage Aug 30, 2016
.dockerignore gomvpkg -from github.com/cockroachdb/cockroach/client -to github.com/… Jun 30, 2016
.editorconfig Add `.editorconfig` and update style notes. Nov 25, 2015
.gitattributes gitattributes: ignore all generated protobuf code Jun 20, 2016
.gitignore Add acceptance.test to gitignore. Aug 24, 2016
.go-version Bump to go1.7rc3 Aug 3, 2016
.mailmap Populate a .mailmap to enhance the output of git blame/shortlog/etc. May 5, 2016
CONTRIBUTING.md Merge branch 'master' into merge-master Aug 19, 2016
GLOCKFILE Merge branch 'master' into develop Aug 30, 2016
LICENSE Added copyright attribution and AUTHORS file. Feb 13, 2014
Makefile Merge branch 'master' into develop Aug 29, 2016
README.md remove google groups and add forum Jul 28, 2016
STYLE.md *: format maybe-nil errors as %v Aug 18, 2016
circle.yml Merge branch 'master' into develop Aug 29, 2016
main.go Remove explicit "init" step to start a cluster Feb 3, 2016



Circle CI GoDoc Project Status Gitter

A Scalable, Survivable, Strongly-Consistent SQL Database

What is CockroachDB?

CockroachDB is a distributed SQL database built on a transactional and strongly-consistent key-value store. It scales horizontally; survives disk, machine, rack, and even datacenter failures with minimal latency disruption and no manual intervention; supports strongly-consistent ACID transactions; and provides a familiar SQL API for structuring, manipulating, and querying data.

For more details, see our FAQ and original design document.


CockroachDB is currently in beta. See our Roadmap and Issues for a list of features planned or in development.


For guidance on installation, development, deployment, and administration, see our User Documentation.


  1. Install Cockroach DB.

  2. Start a local cluster with three nodes listening on different ports:

    $ ./cockroach start --background
    $ ./cockroach start --store=cockroach-data2 --port=26258 --http-port=8081 --join=localhost:26257 --background
    $ ./cockroach start --store=cockroach-data3 --port=26259 --http-port=8082 --join=localhost:26257 --background
  3. Start the built-in SQL client as an interactive shell:

    $ ./cockroach sql
    # Welcome to the cockroach SQL interface.
    # All statements must be terminated by a semicolon.
    # To exit: CTRL + D.
  4. Run some CockroachDB SQL statements:

    root@:26257> CREATE DATABASE bank;
    root@:26257> SET DATABASE = bank;
    root@:26257> CREATE TABLE accounts (id INT PRIMARY KEY, balance DECIMAL);
    root@26257> INSERT INTO accounts VALUES (1234, 10000.50);
    INSERT 1
    root@26257> SELECT * FROM accounts;
    |  id  | balance  |
    | 1234 | 10000.50 |
  5. Checkout the admin UI by pointing your browser to http://<localhost>:8080.

  6. CockroachDB makes it easy to secure a cluster.

Client Drivers

CockroachDB supports the PostgreSQL wire protocol, so you can use any available PostgreSQL client drivers to connect from various languages. For recommended drivers that we've tested, see Install Client Drivers.


  • Manual - Steps to deploy a CockroachDB cluster manually on multiple machines.

  • Cloud - Configuration files and instructions for deploying an insecure development or test cluster on GCE or AWS using Terraform.

Get In Touch

Report a Bug

For filing bugs, suggesting improvements, or requesting new features, help us out by opening an issue.

Need Help?


We're an open source project and welcome contributions.

  1. See CONTRIBUTING.md to get your local environment set up.

  2. Take a look at our open issues, in particular those with the helpwanted label.

  3. Review our style guide and follow our code reviews to learn about our style and conventions.

  4. Make your changes according to our code review workflow.

Tech Talks

For recordings and slides from talks given by CockroachDB founders and engineers, see Tech Talks.


This is an overview. For an in-depth discussion of the design and architecture, see the full design doc. For another quick design overview, see the CockroachDB tech talk slides.


CockroachDB is a distributed SQL database built on top of a transactional and consistent key:value store. The primary design goals are support for ACID transactions, horizontal scalability and survivability, hence the name. CockroachDB implements a Raft consensus algorithm for consistency. It aims to tolerate disk, machine, rack, and even datacenter failures with minimal latency disruption and no manual intervention. CockroachDB nodes (RoachNodes) are symmetric; a design goal is homogeneous deployment (one binary) with minimal configuration.

CockroachDB implements a single, monolithic sorted map from key to value where both keys and values are byte strings (not unicode). CockroachDB scales linearly (theoretically up to 4 exabytes (4E) of logical data). The map is composed of one or more ranges and each range is backed by data stored in RocksDB (a variant of LevelDB), and is replicated to a total of three or more CockroachDB servers. Ranges are defined by start and end keys. Ranges are merged and split to maintain total byte size within a globally configurable min/max size interval. Range sizes default to target 64M in order to facilitate quick splits and merges and to distribute load at hotspots within a key range. Range replicas are intended to be located in disparate datacenters for survivability (e.g. { US-East, US-West, Japan }, { Ireland, US-East, US-West} , { Ireland, US-East, US-West, Japan, Australia }).

Single mutations to ranges are mediated via an instance of a distributed consensus algorithm to ensure consistency. We’ve chosen to use the Raft consensus algorithm. All consensus state is stored in RocksDB.

A single logical mutation may affect multiple key/value pairs. Logical mutations have ACID transactional semantics. If all keys affected by a logical mutation fall within the same range, atomicity and consistency are guaranteed by Raft; this is the fast commit path. Otherwise, a non-locking distributed commit protocol is employed between affected ranges.

CockroachDB provides snapshot isolation (SI) and serializable snapshot isolation (SSI) semantics, allowing externally consistent, lock-free reads and writes--both from an historical snapshot timestamp and from the current wall clock time. SI provides lock-free reads and writes but still allows write skew. SSI eliminates write skew, but introduces a performance hit in the case of a contentious system. SSI is the default isolation; clients must consciously decide to trade correctness for performance. CockroachDB implements a limited form of linearalizability, providing ordering for any observer or chain of observers.

Similar to Spanner directories, CockroachDB allows configuration of arbitrary zones of data. This allows replication factor, storage device type, and/or datacenter location to be chosen to optimize performance and/or availability. Unlike Spanner, zones are monolithic and don’t allow movement of fine grained data on the level of entity groups.

SQL - NoSQL - NewSQL Capabilities

SQL - NoSQL - NewSQL Capabilities