Quickstart

Get etcd up and running in less than 5 minutes!

Follow these instructions to locally install, run, and test a single-member cluster of etcd:

1. Install etcd from pre-built binaries or from source. For details, see Install.

Important: Ensure that you perform the last step of the installation instructions to verify that etcd is in your path. 2. Launch etcd:

1. $ etcd 2. {"level":"info","ts":"2021-09-17T09:19:32.783-0400","caller":"etcdmain/etcd.go:72","msg":... } 3. ⋮

Note: The output produced by etcd are logs — info-level logs can be ignored. 3. From another terminal, use etcdctl to set a key:

1. $ etcdctl put greeting "Hello, etcd" 2. OK 4. From the same terminal, retrieve the key:

1. $ etcdctl get greeting 2. greeting 3. Hello, etcd

What’s next?

Learn about more ways to configure and use etcd from the following pages:

• If you are a developer:

• Explore the gRPC API.

• Find language bindings and tools.

• If you are an operator or admin:

• Set up a multi-machine cluster.

• Learn how to configure etcd.
• Use TLS to secure an etcd cluster.
• Tune etcd.

Last modified May 30, 2025: Fix lint errors indentation (ce545c8)