Quickstart

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:

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

   Note: The output produced by etcd are logs — info-level logs can be ignored.

3. From another terminal, use etcdctl to set a key:

   $ etcdctl put greeting "Hello, etcd"
   OK
   

4. From the same terminal, retrieve the key:

   $ etcdctl get greeting
   greeting
   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.