Skip to main content

etcd V3 Quickstart Guide

etcd is a distributed key value store that provides a reliable way to store data across a cluster of machines.

Get started

1. Prerequisites

2. Start etcd

etcd uses gcr.io/etcd-development/etcd as a primary container registry.
You may also setup etcd with TLS following this documentation here

3. Setup MinIO with etcd

MinIO server expects environment variable for etcd as MINIO_ETCD_ENDPOINTS, this environment variable takes many comma separated entries.
NOTE: If etcd is configured with Client-to-server authentication with HTTPS client certificates then you need to use additional envs such as MINIO_ETCD_CLIENT_CERT pointing to path to etcd-client.crt and MINIO_ETCD_CLIENT_CERT_KEY path to etcd-client.key .

4. Test with MinIO STS API

Once etcd is configured, any STS configuration will work including Client Grants, Web Identity or AD/LDAP. For example, you can configure STS with Client Grants (KeyCloak) using the guides at MinIO STS Quickstart Guide and KeyCloak Configuration Guide. Once this is done, STS credentials can be generated:
These credentials can now be used to perform MinIO API operations, these credentials automatically expire in 1hr. To understand more about credential expiry duration and client grants STS API read further here.

Explore Further