See Release Notes for what's new in the latest release, v20.2.19. To upgrade to this release from an older version, see Cluster Upgrade.
To deploy a free CockroachDB Cloud cluster instead of running CockroachDB yourself, see the Quickstart.
Install options
Use one of the options below to install CockroachDB.
Download the executable
-
Download and extract the CockroachDB v20.2.19 archive for Windows.
-
To ensure that CockroachDB can use location-based names as time zone identifiers, download Go's official zoneinfo.zip and set the
ZONEINFO
environment variable to point to the zip file. -
Open PowerShell, navigate to the directory containing the executable, and make sure it works:
PS C:\cockroach-v20.2.19.windows-6.2-amd64> .\cockroach.exe version
-
Keep up-to-date with CockroachDB releases and best practices:
Use Kubernetes
To orchestrate CockroachDB locally using Kubernetes, either with configuration files or the Helm package manager, see Orchestrate CockroachDB Locally with Minikube.
Use Docker
-
Install Docker for Windows.
Docker for Windows requires 64bit Windows 10 Pro and Microsoft Hyper-V. Please see the official documentation for more details. Note that if your system does not satisfy the stated requirements, you can try using Docker Toolbox. -
Open PowerShell and confirm that the Docker daemon is running in the background:
PS C:\Users\username> docker version
If you do not see the server listed, start Docker for Windows.
-
Share your local drives. This makes it possible to mount local directories as data volumes to persist node data after containers are stopped or deleted.
-
Pull the image for the v20.2.19 release of CockroachDB from Docker Hub:
PS C:\Users\username> docker pull cockroachdb/cockroach:v20.2.19
-
Keep up-to-date with CockroachDB releases and best practices:
What's next?
- If you're just getting started with CockroachDB:
- Start a cluster locally and talk to it via the built-in SQL client
- Learn more about CockroachDB SQL
- Build a simple application with CockroachDB using Postgres-compatible client drivers and ORMs
- Explore core CockroachDB features like automatic replication, rebalancing, and fault tolerance
- If you're ready to run CockroachDB in production: