Build Status

The etcd-viewer is a java web application that allows you to navigate and modify etcd distributed key-value stores.

The application uses the etcd rest API to communicate with the underlying key-value store.

Getting Started

navigation screen

Run with docker

The easiest way to get etcd-viewer is to run a docker container with the etcd-viewer image:

docker run -d -p 8080:8080 nikfoundas/etcd-viewer

The docker container will deploy the etcd-viewer war file to a jetty servlet container. The docker image is built on top of the jetty:latest image.

Build etcd-viewer

In order to build etcd-viewer you need java-1.7 and maven 3.0.5 or later.

git clone

mvn clean install

mvn jetty:run

docker build -t some-repo/etcd-viewer .

Embed components within your wicket application

If your application is built with wicket you can also use the components - panels from etcd-viewer to embed the browsing - editing functionality in your application.


Supported etcd API

Etcd viewer supports the following actions via the etcd rest API:

add node

confirm delete

Multiple etcd key-value stores

You can navigate and modify multiple etcd key-value stores without having to run the application more than once. The etcd clusters are stored in memory and they are forgotten after the application is restarted.

You can add and remove etcd key-value stores at any time. Removing an etcd registry from the etcd-viewer does not affect the contents of the registry itself.

multiple clusters

Leader auto detection

In order to add an etcd cluster registry you only need to provide one alive etcd host. The application discovers the rest of the cluster hosts and detects the leader node. All reads and writes are then directed to the leader node to avoid redirections.

Etcd cluster monitor

Etcd viewer enables you to view the machines that participate in the etcd cluster along with their status - leader or follower. If some etcd host is not accessible then it is marked with red to indicate that it is down. Note that for single node etcd registries no status is reported by etcd.

cluster monitor

Responsive css

etcd-viewer uses bootstrap css framework to enable key-value storage accessibility even from mobile devices or tablets.


Next steps


etcd-viewer uses the following open source libraries and frameworks:



etcd-viewer is released under the Apache 2.0 license. See the LICENSE file for details.