Windows Installation Using Docker

The Hummingbot code base is designed and optimized for UNIX-based systems such as macOS and Linux. We recommend that Windows users either:

Hummingbot can also be installed by utilizing the built-in Windows Subsystem for Linux. However, this is only recommended for users familiar with development.

Installing Hummingbot via the Docker Toolbox

For Windows users without Windows-Pro or Windows-Enterprise, you will need to install the Docker Toolbox, as Windows-Home is not supported by the standard Docker application. Below, we list instructions for running Hummingbot using the Docker Toolbox.

Step 1. Install Docker Toolbox

Download the latest version Docker Toolbox .exe file at the following link: Docker Toolbox Releases.

Docker Download

Locate the installer in the downloads folder and run a full installation with included VirtualBox and Git for Windows. (Git is the default shell used by Docker)

Docker Installation

By default, a shortcut to the Docker Quickstart terminal will be created on your desktop. You can open Docker Toolbox using this shortcut.

Docker Startup

Step 2. Run Hummingbot

Open Docker Toolbox using the Quickstart shortcut. Move onto the next step when you reach the following screen.

Docker Ready

Enter the following commands into the command line. You can install Hummingbot by selecting either of the following options from the tabs below:

  1. Easy Install: download and use automated install scripts.
  2. Manual Installation: run install commands manually.
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# 1) Navigate to root folder
cd ~

# 2) Download Hummingbot install script
curl https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/create.sh -o create.sh

# 3) Enable script permissions
chmod a+x create.sh

# 4) Run installation
./create.sh
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
# 1) Navigate to root folder
cd ~

# 2) Create folder for your new instance
mkdir hummingbot_files

# 3) Create folders for log and config files
mkdir hummingbot_files/hummingbot_conf && mkdir hummingbot_files/hummingbot_logs

# 4) Launch a new instance of hummingbot
docker run -it \
--name hummingbot-instance \
--mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_conf,destination=/conf/" \
--mount "type=bind,source=$(pwd)/hummingbot_files/hummingbot_logs,destination=/logs/" \
coinalpha/hummingbot:latest