You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
craig[bot] a92c7d01d3 Merge #40902 2 days ago
.github CODEOWNERS: (re-)register cli-prs for pkg/cli 3 weeks ago
build githooks: enhance Release justification error message 6 days ago
c-deps c-deps: bump rocksdb to revert compaction snapshot refresh 4 days ago
cloud cloud: update kubernetes configs to 19.1.3 2 months ago
docs sql,sqlbase,client: bootstrap TableDescriptor timestamps from MVCC 5 days ago
githooks githooks: add Release justification hint and lint 1 week ago
licenses licenses: Add BSL.txt 3 months ago
monitoring monitoring: add expiration alerts for optional certificates. 1 year ago
pkg Merge #40902 2 days ago
scripts scripts/release-notes.py: help the user with --from/--until 2 months ago
vendor @ 996c91d92a build: Update x/net/html dependency 4 days ago
.editorconfig editorconfig: Use tabs for Makefile indentation 6 months ago
.gitattributes sql: clean up the `array` logic test 6 months ago
.gitignore cmd/fuzz: add new fuzz command 1 month ago
.gitmodules Revert "Revert "deps: configure and build patched libedit"" 3 months ago
AUTHORS Add Céline to AUTHORS 1 week ago
CONTRIBUTING.md docs: explain that the builder image needs more RAM 3 weeks ago
Gopkg.lock build: Update x/net/html dependency 4 days ago
Gopkg.toml vendor: petermattis/pebble -> cockroachdb/pebble migration 2 weeks ago
LICENSE licenses: Add BSL.txt 3 months ago
Makefile makefile: increase test timeout 5 days ago
README.md README: remove links to gitter 6 months ago

README.md

CockroachDB

CockroachDB is a cloud-native SQL database for building global, scalable cloud services that survive disasters.

TeamCity CI GoDoc

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 or architecture document.

Here’s a quick explainer video:

Status

CockroachDB is production-ready. See our Roadmap for a list of features planned or in development.

Docs

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

Quickstart

  1. Install CockroachDB.

  2. Start a local cluster and talk to it via the built-in SQL client.

  3. Learn more about CockroachDB SQL.

  4. Use a PostgreSQL-compatible driver or ORM to build an app with CockroachDB.

  5. Explore core features, such as data replication, automatic rebalancing, and fault tolerance and recovery.

Client Drivers

CockroachDB supports the PostgreSQL wire protocol, so you can use any available PostgreSQL client drivers to connect from various languages.

Deployment

  • Test Deployment - Easiest way to test an insecure, multi-node CockroachDB cluster.
  • Production Deployments
    • Manual - Steps to deploy a CockroachDB cluster manually on multiple machines.
    • Cloud - Guides for deploying CockroachDB on various cloud platforms.
    • Orchestration - Guides for running CockroachDB with popular open-source orchestration systems.

Need Help?

Contributing

We’re an open source project and welcome contributions. See our Contributing Guide for more details.

Engineering discussion takes place on our public mailing list, cockroach-db@googlegroups.com.

Design

For an in-depth discussion of the CockroachDB architecture, see our Architecture Guide.

For the original design motivation, see our design doc.

Comparison with Other Databases

To see how key features of CockroachDB stack up against other databases, visit the CockroachDB in Comparison page on our website.

See Also