Awesome Open Source
Awesome Open Source

⚠️ Deprecation Notice

The Fabric-Baseimage repository and the images built from this repository are deprecated. Critical bugs will continue to be patched through the Fabric 1.4.x LTS lifecycle. The images affected by this deprecation are:

  • hyperledger/fabric-baseimage (with a version < 1.0.0)
  • hyperledger/fabric-baseos (with a version < 1.0.0)
  • hyperledger/fabric-couchdb (all versions)
  • hyperledger/fabric-zookeeper (all versions)
  • hyperledger/fabric-kafka (all versions)

Users should migrate to open source versions of these images.

Baseimage Introduction

This directory contains the infrastructure for creating a new baseimage used as the basis for various docker images consumed within the Hyperledger Fabric workflow such as chaincode compilation/execution, unit-testing, and even cluster simulation. It is based on ubuntu-16.04 with various opensource projects added such as golang, grpc, and node.js. The actual Hyperledger code is injected just-in-time before deployment. The resulting images are published to image registries such as

The purpose of this baseimage is to act as a bridge between a raw ubuntu/xenial configuration and the customizations required for supporting a Hyperledger Fabric environment. Some of the FOSS components that need to be added to Ubuntu do not have convenient native packages. Therefore, they are built from source. However, the build process is generally expensive (often taking in excess of 30 minutes) so it is fairly inefficient to JIT assemble these components on demand.

Therefore, the expensive FOSS components are built into this baseimage once and subsequently cached on the public repositories so that workflows may simply consume the objects without requiring a local build cycle.

Intended Audience

This repository is only intended for release managers curating the base images. Typical developers may safely ignore this completely. Anyone wishing to customize their image is encouraged to do so via downstream means, such as a custom Dockerfile.


If a component is found to be both broadly applicable and expensive to build JIT, it may be a candidate for inclusion in a future baseimage.


  • "make docker" will build the docker images and commit it to your local environment; e.g. "hyperledger/fabric-baseimage". The docker image is also tagged with architecture and release details.
  • "make install" build build the docker images and push them to Docker Hub.

Creative Commons License
This work is licensed under a Creative Commons Attribution 4.0 International License.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Shell (230,885
Blockchain (8,330
Docker Image (4,764
Hyperledger (456
Distributed Ledger (137
Related Projects