Docker-Blockchain-Explorer

Docker images for Hyperledger Blockchain Explorer.

Supported tags and respective Dockerfile links

• latest (latest/Dockerfile): Default to use latest code on master branch.

For more information about this image and its history, please see the relevant manifest file in the yeasy/docker-blockchain-explorer GitHub repo.

If you want to quickly deploy a local cluster with explorer enabled, please refer to Start hyperledger cluster using Compose.

What is docker-blockchain-explorer?

Docker image with an web-UI explorer for a running hyperledger chain.

How to use this image?

The docker image is auto built at https://registry.hub.docker.com/u/yeasy/blockchain-explorer/.

In Dockerfile

FROM yeasy/blockchain-explorer:latest

Local Run

Quick start

The easiest way to start a explorer is just run

$ docker run -d yeasy/blockchain-explorer

It will listen on <container>:9090, and try connect to 127.0.0.1:7050 as the hyperledger fabric rest api url.

With configuration

Environment variables are supported:

• HTTP_PORT=<web server port. Default is 9090 if not set>
• HYP_REST_ENDPOINT=<REST endpoint. Default is http://127.0.0.1:7050 if not set>

E.g., suppose the hyperledger rest api url is http://172.17.0.2:7050.

$ docker run -p 9090:9090 -e HYP_REST_ENDPOINT=http://172.17.0.2:7050 yeasy/blockchain-explorer

Which image is based on?

The image is built based on node:6-wheezy base image.

What has been changed?

Install dependencies

Install required tools

$ npm install npm bower grunt-cli graceful-fs@4.1.5 minimatch@3.0.2 -g
$ apk update && apk add git

Clone code from github and install dependencies

$ git clone https://github.com/hyperledger/blockchain-explorer
$ cd blockchain-explorer/explorer_1
$ npm install grunt grunt-auto-install grunt-contrib-uglify grunt-contrib-copy
$ grunt

Start the project

$ node exp-server.js

Supported Docker versions

This image is officially supported on Docker version 1.9.0+.

Support for older versions (down to 1.0) is provided on a best-effort basis.

Known Issues

• N/A.

User Feedback

Documentation

Be sure to familiarize yourself with the repository's README.md file before attempting a pull request.

Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue.

You can also reach many of the official image maintainers via the email.

Contributing

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.