See Release Notes for what's new in the latest release, v19.1.2. To upgrade to this release from an older version, see Cluster Upgrade.

Download the Binary

Native CockroachDB on Windows is experimental, and is largely untested by Cockroach Labs. This prebuilt binary is provided as a convenience for local development and experimentation; production deployments of CockroachDB on Windows are strongly discouraged. Windows 8 or higher is required.
  1. Download and extract the CockroachDB v19.1.2 archive for Windows.

  2. Open PowerShell, navigate to the directory containing the binary, and make sure the CockroachDB executable works:

    PS C:\> .\cockroach.exe version
  3. 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

Running a stateful application like CockroachDB in Docker is more complex and error-prone than most uses of Docker. Unless you are very experienced with Docker, we recommend starting with a different installation and deployment method.
  1. 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.
  2. 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.

  3. 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.

  4. Pull the image for the v19.1.2 release of CockroachDB from Docker Hub:

    PS C:\Users\username> docker pull cockroachdb/cockroach:v19.1.2
  5. Keep up-to-date with CockroachDB releases and best practices:

What's next?

By default, each node of a CockroachDB cluster periodically shares anonymous usage details with Cockroach Labs. For an explanation of the details that get shared and how to opt-out of reporting, see Diagnostics Reporting.

Yes No