cockroach

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

• What is CockroachDB?
• Docs
• Quickstart
• Client Drivers
• Deployment
• Need Help?
• Contributing
• Design
• Comparison with Other Databases
• See Also

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.

Status

CockroachDB is production-ready. See our 1.1 milestone 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.

• For recommended drivers that we've tested, see Install Client Drivers.

• For tutorials using these drivers, as well as supported ORMs, see Build an App with CockroachDB.

Deployment

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

• Cloud Deployment - Guides for deploying CockroachDB on various cloud platforms.

• Orchestration - Guides for running CockroachDB with popular open-source orchestration systems.

Need Help?

• Troubleshooting documentation - Learn how to troubleshoot common errors, cluster and node setup, and SQL query behavior, and how to use debug and error logs.

• CockroachDB Forum and Stack Overflow - Ask questions, find answers, and help other users.

• Join us on Gitter - This is the most immediate way to connect with CockroachDB engineers.

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

Contributing

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