Install Consul

1. Using a precompiled binary

2. Installing

Downloading a precompiled binary is easiest, and we provide downloads over TLS along with SHA256 sums to verify the binary. We also distribute a PGP signature with the SHA256 sums that can be verified.

To install the precompiled binary, download the appropriate package for your system. Consul is currently packaged as a zip file. We do not have any near term plans to provide system packages.

Once the zip is downloaded, unzip it into any directory. The binary inside is all that is necessary to run Consul (or consul.exe for Windows). No additional files are required to run Consul.

Copy the binary to anywhere on your system. If you intend to access it from the command-line, make sure to place it somewhere on your PATH.

To compile from source, you will need installed and configured properly (including a environment variable set), as well as a copy of git in your PATH.

2. Build Consul for your current system and put the binary in (relative to the git checkout). The make dev target is just a shortcut that builds consul for only your local build environment (no cross-compiled targets).

To verify Consul is properly installed, run on your system. You should see help output. If you are executing it from the command line, make sure it is on your PATH or you may get an error about Consul not being found.

Consul currently supports all ‘evergreen’ browsers, as they are generally on up-to-date versions. For more information on supported browsers, please see our