Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

vpc - FreeBSD Virtual Private Cloud ("VPC")


A version of VPC can be run under Vagrant using VMWare Fusion or Workstation. This is distributed across multiple boxes which makes it suitable for some types of development, as well as for creating disposable environments for integration testing. The development environment consists of a compilation machine, a three-node CockroachDB cluster and (optionally) compute nodes.

The CockroachDB cluster uses the TLS certificates in vagrant/certs both for client authentication and encryption of intra-node traffic.

To build an environment consisting of a three-node CockroachDB cluster and a box with the compiler and relevant development tools installed, run the following command in the root directory of the repository:

vagrant up crdb1 crdb2 crdb3 compile

The following dependencies must be installed on the host:

  • Vagrant
  • VMWare Fusion 10 or VMWare Workstation 141
  • Vagrant VMWare Plugin for Fusion or Workstation respectively
  • vagrant-winnfs if running on a Windows host

vpc Command Shell Auto Completion

Assuming shells/bash-completion has already been installed, add the following to your ~/.bashrc:

[[ $PS1 && -f /usr/local/share/bash-completion/ ]] && \
    source /usr/local/share/bash-completion/
[[ $PS1 && -f `go env GOPATH`/src/ ]] && \
    source `go env GOPATH`/src/


[1]: It is possible to build boxes for Virtualbox, but since nested virtualization is not supported under Virtualbox, it is not possible to test running instances in virtual machines.