milvus-logo

etcd-related Configurations

This topic introduces the etcd-related configurations of Milvus. etcd is the metadata engine supporting Milvus' metadata storage and access.

In this section, you can configure etcd endpoints, relevant key prefixes, etc.

To share an etcd instance among multiple Milvus instances, you need to change etcd.rootPath to a unique value for each of the Milvus instances. For details, refer to Operation FAQs.

etcd.endpoints

Description Default Value
  • Endpoints used to access etcd service. You can change this parameter as the endpoints of your own etcd cluster.
  • Environment variable: ETCD_ENDPOINTS
  • etcd preferentially acquires valid address from environment variable ETCD_ENDPOINTS when Milvus is started.
  • localhost:2379

    etcd.rootPath

    Description Default Value
  • Root prefix of the key to where Milvus stores data in etcd.
  • It is recommended to change this parameter before starting Milvus for the first time.
  • To share an etcd instance among multiple Milvus instances, consider changing this to a different value for each Milvus instance before you start them. For details, see Operation FAQs.
  • Set an easy-to-identify root path for Milvus if etcd service already exists.
  • Changing this for an already running Milvus instance may result in failures to read legacy data.
  • by-dev

    etcd.metaSubPath

    Description Default Value
  • Sub-prefix of the key to where Milvus stores metadata-related information in etcd.
  • Caution: Changing this parameter after using Milvus for a period of time will affect your access to old data.
  • It is recommended to change this parameter before starting Milvus for the first time.
  • meta

    etcd.kvSubPath

    Description Default Value
  • Sub-prefix of the key to where Milvus stores timestamps in etcd.
  • Caution: Changing this parameter after using Milvus for a period of time will affect your access to old data.
  • It is recommended not to change this parameter if there is no specific reason.
  • kv
    On this page