Install CockroachDB on Windows

Download the executable

1. Use PowerShell to download the CockroachDB v21.2.17 archive for Windows and copy the binary into your PATH:

   PS $ErrorActionPreference = "Stop"; [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12;$ProgressPreference = 'SilentlyContinue'; $null = New-Item -Type Directory -Force $env:appdata/cockroach; Invoke-WebRequest -Uri https://binaries.cockroachdb.com/cockroach-v21.2.17.windows-6.2-amd64.zip -OutFile cockroach.zip; Expand-Archive -Force -Path cockroach.zip; Copy-Item -Force "cockroach/cockroach-v21.2.17.windows-6.2-amd64/cockroach.exe" -Destination $env:appdata/cockroach; $Env:PATH += ";$env:appdata/cockroach"

   We recommend adding ;$env:appdata/cockroach to the PATH variable for your system environment so you can execute cockroach commands from any shell. See Microsoft's environment variable documentation for more information.

2. Run the following command to make sure the installation succeeded:

   PS cockroach version

3. Keep up-to-date with CockroachDB releases and best practices:

   Thanks!

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

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 v21.2.17 release of CockroachDB from Docker Hub:

   PS C:\Users\username> docker pull cockroachdb/cockroach:v21.2.17

5. Keep up-to-date with CockroachDB releases and best practices:

   Thanks!