From 02975afe37cf40e2291910b2eafd520ca4ea3ca1 Mon Sep 17 00:00:00 2001 From: Josh Wood Date: Tue, 8 Mar 2016 10:28:29 -0800 Subject: [PATCH] README: Add explanation about official vs legacy ports Add a note about 2379/2380 vs 4001/7001. I believe this is as far as we can go just yet, because we have not fully deprecated the old ports, and still want to configure them in some instances. Related #3480. --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index cd7bc5c33..4be075bd8 100644 --- a/README.md +++ b/README.md @@ -62,6 +62,12 @@ curl -L http://127.0.0.1:2379/v2/keys/mykey You have successfully started an etcd and written a key to the store. +### etcd TCP ports + +The [official etcd ports][iana-ports] are 2379 for client requests, and 2380 for peer communication. To maintain compatibility, some etcd configuration and documentation continues to refer to the legacy ports 4001 and 7001, but all new etcd use and discussion should adopt the IANA-assigned ports. The legacy ports 4001 and 7001 will be fully deprecated, and support for their use removed, in future etcd releases. + +[iana-ports]: https://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml?search=etcd + ### Running local etcd cluster First install [goreman](https://github.com/mattn/goreman), which manages Procfile-based applications.