The Hyperledger Composer pre-requisites can be installed on Ubuntu or MacOS. Choose your operating system to jump to the appropriate section, or scroll down to find the instructions:
To run Hyperledger Composer and Hyperledger Fabric, we recommend you have at least 4Gb of memory.
The following are prerequisites for installing the required development tools:
- Operating Systems: Ubuntu Linux 14.04 / 16.04 LTS (both 64-bit), or Mac OS 10.12
- Docker Engine: Version 17.03 or higher
- Docker-Compose: Version 1.8 or higher
- Node: 8.9 or higher (note version 9 is not supported)
- npm: v5.x
- git: 2.9.x or higher
- Python: 2.7.x
- A code editor of your choice, we recommend VSCode.
**If installing Hyperledger Composer using Linux, be aware of the following advice:
- Login as a normal user, rather than root.
- Do not
suto root. - When installing prerequisites, use curl, then unzip using sudo.
- Run prereqs-ubuntu.sh as a normal user. It may prompt for root password as some of it's actions are required to be run as root.
- Do not use npm with
sudoorsuto root to use it. - Avoid installing node globally as root.**
If you're running on Ubuntu, you can download the prerequisites using the following commands:
curl -O https://hyperledger.github.io/composer/v0.19/prereqs-ubuntu.shchmod u+x prereqs-ubuntu.shNext run the script - as this briefly uses sudo during its execution, you will be prompted for your password.
./prereqs-ubuntu.shWhat next?
Congratulations, the installation of the pre-requisites for Hyperledger Composer is complete! You can now proceed with Installing the development environment.
Follow these instructions to install the pre-requsities for installing Hyperledger Composer on a local Mac OS X machine. You need to install these tools before you attempt to install Hyperledger Composer.
Note Mac OS X version
10.12.6was used for these instructions.
Install nvm and Apple Xcode
First install nvm (the Node version manager). nvm is a tool that allows you to easily install, update and switch between versions of Node.js.
Open the terminal (command line) by clicking on the magnifier in the menu bar at the top right of your screen. Type terminal and press enter.
In the terminal window paste the text below and press enter:
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bashMore information on this script and the Node install process is available here.
When you hit enter you should see the pop-up below, prompting you to install git. Press the Get Xcode button to install the full Apple Xcode IDE, including a C++ compiler, used to install native Node.js modules.
The download and install process for Xcode may take 20 minutes or more. Be patient!
After the installation of Xcode has completed launch Xcode. Accept the license agreement. It will prompt you for your username and password and will install additional components.
After Xcode finishes installing additional components and launches, simply quit Xcode.
Switch back to the terminal and create your bash profile (stores user preferences for bash):
touch .bash_profileThen rerun the original curl command:
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bashClose the terminal and reopen it.
Check that nvm is installed and is accessible:
nvm —-versionInstall Node
Install the latest (long term support) version of Node:
nvm install --ltsSwitch to the LTS version of Node:
nvm use --ltsCheck that Node is installed:
node --versionInstall Docker
Follow the instructions here to install Docker for Mac (stable):https://docs.docker.com/docker-for-mac/install/
After running the installed Docker application you should have the whale icon in your menu bar, with a green “Docker is running” status.
Install VSCode
Install VSCode by visiting:https://code.visualstudio.com
Press the “Download for Mac” button and copy the downloaded application into your Applications folder.
Install the Hyperledger Composer Extension for VSCode
Launch VSCode and then press the “Extensions” button on the vertical left toolbar.
Type composer into the search bar and then press the Install button next to the Hyperleger Composer extension. Once the install completes you need to press the Reload button to activate the extension.
What next?
Congratulations, the installation of the pre-requisites for Hyperledger Composer is complete! You can now proceed with Installing the development environment.
