Version v3.7-DRAFT of the documentation is in DRAFT status. For the latest stable documentation, see v3.6.

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:

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

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.

From another terminal, use etcdctl to set a key:
```
$ etcdctl put greeting "Hello, etcd"
OK
```

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.

Was this page helpful?

Sorry to hear that. Please tell us how we can improve.