Install from Docker¶
Using a pre-compiled version of
hummingbot from Docker allows you to run
hummingbot with a single line command.
Docker images of
hummingbot are available on Docker Hub at coinalpha/hummingbot.
Docker installation for Windows¶
For Windows users without Windows-Pro or Windows-Enterprise, you will need to install the Docker Toolbox. Download the latest version Toolbox .exe file at the following link: Docker Toolbox Releases.
Install Toolbox from the .exe file, including VirtualBox and Git if you do not have those on your computer. Otherwise, maintain default settings and restart after installation.
You can now open Docker via the Quickstart Terminal. On the first start-up, give the Toolbox a few minutes to initialize.
Create new instance of
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
# 1) Create a label for your container and specify which docker # image of hummingbot to use export NAME=myhummingbot && \ export TAG=latest # 2) Specify the path to folders where you would like to save # your config and log files export CONF_PATH=~/hummingbot_conf && \ export LOGS_PATH=~/hummingbot_logs # 3) If the folders do not exist, create them: mkdir ~/hummingbot_conf && \ mkdir ~/hummingbot_logs # 4) Launch hummingbot with the parameters you specified docker run -it \ --name $NAME \ --mount "type=bind,source=$CONF_PATH,destination=/conf/" \ --mount "type=bind,source=$LOGS_PATH,destination=/logs/" \ coinalpha/hummingbot:$TAG
- In the four
exportcommands, replace the values with your custom values.
NAME: name of your container, such as
TAG: with the image version, e.g.
development, or a specific version
CONF_PATH: path on your host machine for
LOGS_PATH: path on your host machine for
Config and log files¶
The above methodology requires you to explicitly specify the paths where you want to mount the
logs/ folders on your local machine.
Note: you must create the folders prior to running the
docker run command.
The folders required on your computer are:
hummingbot_conf/: maps to
conf/folder in the container, where configuration files will be stored
hummingbot_log/: maps to
logsfolder in the container, where logs will be stored
If you have existing
hummingbot_logs/ folders, running the command above will mount the existing
hummingbot_logs/ folders to the newly created docker container instance and allow you to continue using those files.
Reference: Useful Docker commands¶
||List existing, running containers|
||Start an existing, previously created container|
||Connect to an existing, running container|
Update Hummingbot version¶
The following command will update an existing instance of
hummingbot with a new, specified version:
1 2 3 4 5 6 7
docker rm $NAME && \ docker image rm coinalpha/hummingbot:$OLD_TAG && \ docker run -it \ --name $NAME \ -v "$PWD"/conf/:/conf/ \ -v "$PWD"/logs/:/logs/ \ coinalpha/hummingbot:$NEW_TAG