OS
To successfully follow the examples in the Hyperledger Indy Technical Deep Dive training, you will need an operating system that supports docker. We recommend Ubuntu 18.04 or Mac.
Required Tools
If not already installed, you will need to install Git and Docker on your system to be able to do the hands-on Labs during the training. Please use the following steps in your command line tool:
git
Ubuntu 18.04
sudo apt install -y git
Mac
git --version
If Git is not installed, it will prompt you to install it.
Docker
- Only perform steps 1 and 2 from the following link to install docker on Ubuntu: https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-18-04.
- The following can be used as a guide to installing docker on Mac: https://docs.docker.com/desktop/mac/install/
Clone and build from the Git repo:
mkdir gitdir cd gitdir git clone https://github.com/hyperledger/indy-node -b ubuntu-20.04-upgrade cd indy-node docker build -t indy-node-dev -f .devcontainer/Dockerfile .devcontainer/ docker run --rm -it -v $(pwd):/node:z indy-node-dev cd /node pip install .[tests] cd indy_common pytest . cd ../indy_node pytest .
The last few steps (pytest .) might take a long time to run (more than 20 minutes). A few individual test errors are expected at this time, but not more than 10.
NOTE: Ubuntu in a VM:
If Ubuntu is installed in a VirtualBox VM do the following:
- Perform all the steps listed in this tutorial to update your system and enable copy and paste.
- Make sure to restart your VM and that the Shared Clipboard is set to bidirectional:
- In your VM machine settings, in Virtual Box > General > Advanced
- set ‘Shared Clipboard’ to ‘Bidirectional’