{"id":16954459,"url":"https://github.com/m9rco/etcd","last_synced_at":"2026-04-19T10:35:20.926Z","repository":{"id":99183129,"uuid":"185524403","full_name":"m9rco/etcd","owner":"m9rco","description":"Etcd in a Docker container ","archived":false,"fork":false,"pushed_at":"2019-06-12T02:44:52.000Z","size":62,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-26T08:24:33.541Z","etag":null,"topics":["docker","docker-compose","docker-image","etcd"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/m9rco/etcd","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/m9rco.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-08T03:53:07.000Z","updated_at":"2019-06-12T02:44:54.000Z","dependencies_parsed_at":"2023-04-19T20:18:43.696Z","dependency_job_id":null,"html_url":"https://github.com/m9rco/etcd","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m9rco%2Fetcd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m9rco%2Fetcd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m9rco%2Fetcd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m9rco%2Fetcd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/m9rco","download_url":"https://codeload.github.com/m9rco/etcd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244795519,"owners_count":20511521,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["docker","docker-compose","docker-image","etcd"],"created_at":"2024-10-13T22:09:46.060Z","updated_at":"2026-04-19T10:35:15.895Z","avatar_url":"https://github.com/m9rco.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg src=\"logo.png\" width=300/\u003e\n\u003c/p\u003e\n\n# Etcd \n\n\u003cp align=\"center\"\u003e\n  \n[![Author](https://img.shields.io/badge/Author-m9rco-Green.svg?style=flat\u0026logo=tinder)](https://about.me/pushaowei/)\n[![Open Source Love](https://badges.frapsoft.com/os/v2/open-source.svg?v=102)](https://travis-ci.org/m9rco/etcd/)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/m9rco/etcd/pulls)\n[![Build Status](https://travis-ci.org/m9rco/etcd.svg?branch=master)](https://travis-ci.org/m9rco/etcd) \n![Docker Pulls](https://img.shields.io/docker/pulls/m9rco/etcd.svg?style=flat-square)\n\n\u003c/p\u003e\n\n## Images\n\n- [2.0.10](2.0.10)\n- [3.3.13](3.3.13)\n\n\n## Usage\n\nThe recommended way to get the m9rco etcd Docker Image is to pull the prebuilt image from the [Docker Hub Registry](https://hub.docker.com/r/m9rco/etcd).\n\n```sh\ndocker pull m9rco/etcd:latest\n```\n\nTo use a specific version, you can pull a versioned tag. You can view the [list of available versions](https://hub.docker.com/r/m9rco/etcd/tags/) in the Docker Hub Registry.\n\n```sh\n$ docker pull m9rco/etcd:[TAG]\n```\n\n\n## Using the Command Line\n\n\n### Step 1: Create a network\n\n```sh\ndocker network create app-tier --driver bridge\n```\n\n### Step 2: Launch the etcd server instance\n\nUse the --network app-tier argument to the docker run command to attach the etcd container to the app-tier network.\n\n```sh\n docker run -d --name etcd-server \\\n    --network app-tier \\\n    --publish 2379:2379 \\\n    --publish 2380:2380 \\\n    --env ALLOW_NONE_AUTHENTICATION=yes \\\n    --env ETCD_ADVERTISE_CLIENT_URLS=http://etcd-server:2379 \\\n    m9rco/etcd:latest\n```    \n\n### Step 3: Launch your etcd client instance\n\nFinally we create a new container instance to launch the etcd client and connect to the server created in the previous step:\n\n```\ndocker run -it --rm \\\n    --network app-tier \\\n    --env ALLOW_NONE_AUTHENTICATION=yes \\\n    m9rco/etcd:latest etcdctl --endpoints http://etcd-server:2379 set /message Hello\n```\n\n## Exec\n\n```sh\n docker exec 3313_etcd_1 sh -c 'ETCDCTL_API=3  etcdctl get \"name\" \"m9rco\"'\n```\n\n## Using Docker Compose\n\nWhen not specified, Docker Compose automatically sets up a new network and attaches all deployed services to that network. However, we will explicitly define a new bridge network named app-tier. In this example we assume that you want to connect to the etcd server from your own custom application image which is identified in the following snippet by the service name myapp.\n\n```yaml\n\nversion: '2'\n\nnetworks:\n  app-tier:\n    driver: bridge\n\nservices:\n  etcd:\n    image: 'm9rco/etcd:latest'\n    environment:\n      - ALLOW_NONE_AUTHENTICATION=yes\n      - ETCD_ADVERTISE_CLIENT_URLS=http://etcd:2379\n    ports:\n      - 2379:2379\n      - 2380:2380\n    networks:\n      - app-tier\n  myapp:\n    image: 'YOUR_APPLICATION_IMAGE'\n    networks:\n      - app-tier\n```\n\n\u003e IMPORTANT: \u003e \u003e 1. Please update the placeholder YOUR_APPLICATION_IMAGE in the above snippet with your application image \u003e 2. In your application container, use the hostname etcd to connect to the etcd server\n\n### Launch the containers using:\n\n```sh\ndocker-compose up -d\n```\n\n### Configuration\n\nThe configuration can easily be setup by mounting your own configuration file on the directory `/home/app/etcd/conf`:\n\n```sh\ndocker run --name etcd -v /path/to/etcd.conf.yml:/home/app/etcd/conf/etcd.conf.yml m9rco/etcd:latest\n```\n\nAfter that, your configuration will be taken into account in the server's behaviour.\n\nUsing Docker Compose:\n\n```yaml\nversion: '2'\n\nservices:\n  etcd:\n    image: m9rco/etcd:latest\n    environment:\n      - ALLOW_NONE_AUTHENTICATION=yes\n      - ETCD_ADVERTISE_CLIENT_URLS=http://etcd:2379\n    ports:\n      - '2379:2379'\n      - '2380:2380'\n    volumes:\n      - /path/to/etcd.conf.yml:/home/app/etcd/conf/etcd.conf.yml\n```\n\nYou can find a sample configuration file on this link\n\nApart from providing your custom configuration file, you can also modify the server behavior via configuration flags exposed as environment variables.\n\nFor example if you want to modify the flag --my-flag, you will need to set the ETCD_MY_FLAG environment variable.\n\nThe previous rule applies to all etcd flags.\n\n### Further documentation\nFor further documentation, please check etcd documentation or its GitHub repository\n\n### Contributing\nWe'd love for you to contribute to this container. You can request new features by creating an issue, or submit a pull request with your contribution.    \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm9rco%2Fetcd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fm9rco%2Fetcd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm9rco%2Fetcd/lists"}