The instructions below are for Linux and macOS, however, due to the nature of Docker, you may also run this on Windows.
The docker image is in alpha stage. The following instructions may not work for you.
The Docker setup allows you quickly get started with HOPRd without having to download any other software requirements in your machine. This allows you to quickly get started using the system, but has some hardware requirements to be aware of.
To use Docker, you will need a device that supports hardware-level virtualisation: VT-x for Intel-based PCs and AMD-V for AMD processors. Most of the Mac and Linux machines support it out of the box, so ensure you have enough memory (e.g. 2 GB) and disk space (e.g. 1 GB) before starting.
Before doing anything else, you need to install Docker Desktop on your machine. Docker is natively supported in MacOS/Linux, and will prompt you with any additional requirements, depending on your operating system. Depending on your setup, you might need to follow additional steps to ensure your computer works properly with Docker.
Depending of your distribution, please follow the official guidelines for how to install and run Docker on your workstation.
- Visit Docker and download Docker Desktop to your computer.
- Follow the wizard steps to ensure Docker is installed.
- Ensure the installation was successful by running
docker psin your terminal.
Downloading HOPRd image using Docker
Before downloading HOPRd image and starting a container, make sure the Docker is running.
All our docker images can be found in our Google Cloud Container Registry.
Each image is prefixed with
athens tag represents the latest community release version.
Open your console based on your OS:
- Terminal (Mac OS / Linux OS)
Before starting a container, please create your own Security Token. Replace YOUR_SECURITY_TOKEN with your own and only then paste the command.
Security token should contain:
- at least 8 symbols
- a lowercase letter
- uppercase letter
- a number
- a special symbol (don't use
This ensures the node cannot be accessed by a malicious user residing in the same network.
docker run --pull always -ti -v $HOME/.hoprd-db:/app/db -p 9091:9091 -p 3000:3000 -p 3001:3001 gcr.io/hoprassociation/hoprd:athens --admin --password 'open-sesame-iTwnsPNg0hpagP+o6T0KOwiH9RQ0' --init --rest --restHost "0.0.0.0" --restPort 3001 --identity /app/db/.hopr-id-athens --apiToken 'YOUR_SECURITY_TOKEN' --adminHost "0.0.0.0" --adminPort 3000 --host "0.0.0.0:9091"
Also all ports are mapped to your local host, assuming you stick to the default port numbers.
The installation process has been finished! Now you can proceed to Guide using a hoprd node.