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 try CockroachDB Cloud instead of running CockroachDB yourself, refer to the Cloud 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: