Install

Instructions for installing etcd from pre-built binaries or from source.

Requirements

Before installing etcd, see the following pages:

Install pre-built binaries

The easiest way to install etcd is from pre-built binaries:

  1. Download the compressed archive file for your platform from Releases, choosing release v3.5.0 or later.

  2. Unpack the archive file. This results in a directory containing the binaries.

  3. Add the executable binaries to your path. For example, rename and/or move the binaries to a directory in your path (like /usr/local/bin), or add the directory created by the previous step to your path.

  4. From a shell, test that etcd is in your path:

    1. $ etcd --version
    2. etcd Version: 3.5.0
    3. ...

Build from source

If you have Go version 1.16+, you can build etcd from source by following these steps:

  1. Download the etcd repo as a zip file and unzip it, or clone the repo using the following command.

    1. $ git clone -b v3.5.0 https://github.com/etcd-io/etcd.git

    To build from main@HEAD, omit the -b v3.5.0 flag.

  2. Change directory:

    1. $ cd etcd
  3. Run the build script:

    1. $ ./build.sh

    The binaries are under the bin directory.

  4. Add the full path to the bin directory to your path, for example:

    1. $ export PATH="$PATH:`pwd`/bin"
  5. Test that etcd is in your path:

    1. $ etcd --version

Installation check

For a slightly more involved sanity check of your installation, see Quickstart.

Last modified June 14, 2021: Renaming content/en/next folder to content/en/v3.5. Updating redirects, links, and config as needed. (#363) (138926b)