{"id":37118470,"url":"https://github.com/thinkeridea/etcd","last_synced_at":"2026-01-14T13:50:28.902Z","repository":{"id":57592760,"uuid":"107930566","full_name":"thinkeridea/etcd","owner":"thinkeridea","description":"Distributed reliable key-value store for the most critical data of a distributed system","archived":false,"fork":true,"pushed_at":"2017-10-23T02:16:56.000Z","size":34026,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-06-20T13:32:57.394Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://coreos.com/etcd/docs/latest/","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"etcd-io/etcd","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thinkeridea.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-23T04:05:52.000Z","updated_at":"2018-08-28T01:26:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/thinkeridea/etcd","commit_stats":null,"previous_names":[],"tags_count":100,"template":false,"template_full_name":null,"purl":"pkg:github/thinkeridea/etcd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinkeridea%2Fetcd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinkeridea%2Fetcd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinkeridea%2Fetcd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinkeridea%2Fetcd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thinkeridea","download_url":"https://codeload.github.com/thinkeridea/etcd/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinkeridea%2Fetcd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28422355,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T13:30:50.153Z","status":"ssl_error","status_checked_at":"2026-01-14T13:29:08.907Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-14T13:50:28.005Z","updated_at":"2026-01-14T13:50:28.886Z","avatar_url":"https://github.com/thinkeridea.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# etcd\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/coreos/etcd)](https://goreportcard.com/report/github.com/coreos/etcd)\n[![Coverage](https://codecov.io/gh/coreos/etcd/branch/master/graph/badge.svg)](https://codecov.io/gh/coreos/etcd)\n[![Build Status](https://travis-ci.org/coreos/etcd.svg?branch=master)](https://travis-ci.org/coreos/etcd)\n[![Build Status](https://semaphoreci.com/api/v1/coreos/etcd/branches/master/shields_badge.svg)](https://semaphoreci.com/coreos/etcd)\n[![Docker Repository on Quay.io](https://quay.io/repository/coreos/etcd-git/status \"Docker Repository on Quay.io\")](https://quay.io/repository/coreos/etcd-git)\n\n**Note**: The `master` branch may be in an *unstable or even broken state* during development. Please use [releases][github-release] instead of the `master` branch in order to get stable binaries.\n\n*the etcd v2 [documentation](Documentation/v2/README.md) has moved*\n\n![etcd Logo](logos/etcd-horizontal-color.png)\n\netcd is a distributed reliable key-value store for the most critical data of a distributed system, with a focus on being:\n\n* *Simple*: well-defined, user-facing API (gRPC)\n* *Secure*: automatic TLS with optional client cert authentication\n* *Fast*: benchmarked 10,000 writes/sec\n* *Reliable*: properly distributed using Raft\n\netcd is written in Go and uses the [Raft][raft] consensus algorithm to manage a highly-available replicated log.\n\netcd is used [in production by many companies](./Documentation/production-users.md), and the development team stands behind it in critical deployment scenarios, where etcd is frequently teamed with applications such as [Kubernetes][k8s], [fleet][fleet], [locksmith][locksmith], [vulcand][vulcand], [Doorman][doorman], and many others. Reliability is further ensured by rigorous [testing][etcd-tests].\n\nSee [etcdctl][etcdctl] for a simple command line client.\n\n[raft]: https://raft.github.io/\n[k8s]: http://kubernetes.io/\n[doorman]: https://github.com/youtube/doorman\n[fleet]: https://github.com/coreos/fleet\n[locksmith]: https://github.com/coreos/locksmith\n[vulcand]: https://github.com/vulcand/vulcand\n[etcdctl]: https://github.com/coreos/etcd/tree/master/etcdctl\n[etcd-tests]: http://dash.etcd.io\n\n## Getting started\n\n### Getting etcd\n\nThe easiest way to get etcd is to use one of the pre-built release binaries which are available for OSX, Linux, Windows, [rkt][rkt], and Docker. Instructions for using these binaries are on the [GitHub releases page][github-release].\n\nFor those wanting to try the very latest version, [build the latest version of etcd][dl-build] from the `master` branch. This first needs [*Go*](https://golang.org/) installed (version 1.9+ is required). All development occurs on `master`, including new features and bug fixes. Bug fixes are first targeted at `master` and subsequently ported to release branches, as described in the [branch management][branch-management] guide.\n\n[rkt]: https://github.com/rkt/rkt/releases/\n[github-release]: https://github.com/coreos/etcd/releases/\n[branch-management]: ./Documentation/branch_management.md\n[dl-build]: ./Documentation/dl_build.md#build-the-latest-version\n\n### Running etcd\n\nFirst start a single-member cluster of etcd:\n\n```sh\n./bin/etcd\n```\n\nThis will bring up etcd listening on port 2379 for client communication and on port 2380 for server-to-server communication.\n\nNext, let's set a single key, and then retrieve it:\n\n```\nETCDCTL_API=3 etcdctl put mykey \"this is awesome\"\nETCDCTL_API=3 etcdctl get mykey\n```\n\nThat's it! etcd is now running and serving client requests. For more\n\n- [Animated quick demo][demo-gif]\n- [Interactive etcd playground][etcd-play]\n\n[demo-gif]: ./Documentation/demo.md\n[etcd-play]: http://play.etcd.io/\n\n### etcd TCP ports\n\nThe [official etcd ports][iana-ports] are 2379 for client requests, and 2380 for peer communication.\n\n[iana-ports]: http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt\n\n### Running a local etcd cluster\n\nFirst install [goreman](https://github.com/mattn/goreman), which manages Procfile-based applications.\n\nOur [Procfile script](./Procfile) will set up a local example cluster. Start it with:\n\n```sh\ngoreman start\n```\n\nThis will bring up 3 etcd members `infra1`, `infra2` and `infra3` and etcd `grpc-proxy`, which runs locally and composes a cluster.\n\nEvery cluster member and proxy accepts key value reads and key value writes.\n\n### Running etcd on Kubernetes\n\nTo run an etcd cluster on Kubernetes, try [etcd operator](https://github.com/coreos/etcd-operator).\n\n### Next steps\n\nNow it's time to dig into the full etcd API and other guides.\n\n- Read the full [documentation][fulldoc].\n- Explore the full gRPC [API][api].\n- Set up a [multi-machine cluster][clustering].\n- Learn the [config format, env variables and flags][configuration].\n- Find [language bindings and tools][integrations].\n- Use TLS to [secure an etcd cluster][security].\n- [Tune etcd][tuning].\n\n[fulldoc]: ./Documentation/docs.md\n[api]: ./Documentation/dev-guide/api_reference_v3.md\n[clustering]: ./Documentation/op-guide/clustering.md\n[configuration]: ./Documentation/op-guide/configuration.md\n[integrations]: ./Documentation/integrations.md\n[security]: ./Documentation/op-guide/security.md\n[tuning]: ./Documentation/tuning.md\n\n## Contact\n\n- Mailing list: [etcd-dev](https://groups.google.com/forum/?hl=en#!forum/etcd-dev)\n- IRC: #[etcd](irc://irc.freenode.org:6667/#etcd) on freenode.org\n- Planning/Roadmap: [milestones](https://github.com/coreos/etcd/milestones), [roadmap](./ROADMAP.md)\n- Bugs: [issues](https://github.com/coreos/etcd/issues)\n\n## Contributing\n\nSee [CONTRIBUTING](CONTRIBUTING.md) for details on submitting patches and the contribution workflow.\n\n## Reporting bugs\n\nSee [reporting bugs](Documentation/reporting_bugs.md) for details about reporting any issues.\n\n### License\n\netcd is under the Apache 2.0 license. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthinkeridea%2Fetcd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthinkeridea%2Fetcd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthinkeridea%2Fetcd/lists"}