Skip to main content
Skip table of contents

How to run Hummingbot using Docker on Windows


This article will be a step-by-step guide on how to run Hummingbot using Docker on Windows.

Install Docker Desktop

  • We need to use the appropriate installer depending on our Windows edition.
    We can check it by opening the Properties of This PC.


    As an example, our Windows device is Home edition.


    Installers:

    Windows Home Edition
    Windows Pro/Enterprise Edition

  • After going through the installation process, your Docker Desktop should show as below:
  • We will go back to Docker later

Install Ubuntu

  • Next step is to install Ubuntu.
    Open Microsoft Store and search for "Ubuntu 18.04 LTS". Click Install.


  • Open the Ubuntu 18.04 LTS and follow the prompts for entering your Username and Password.
  • We will go back to Ubuntu later.

Enable WSL 2

  • Run Windows PowerShell as Administrator


  • To enable WSL 2, run the command on PowerShell below:
    wsl.exe --set-version Ubuntu-18.04 2


  • To enable the WSL 2 integration on Docker, open Docker Desktop and toggle the Ubuntu 18.04 and click Apply & Restart


Installing Docker and Hummingbot on Ubuntu

  • Going back to Ubuntu, we will install Docker by entering the following commands.
  • Download the Docker install script
    wget https://raw.githubusercontent.com/hummingbot/hummingbot/master/installation/install-docker/install-docker-ubuntu.sh
  • Enable script execution permission
    chmod a+x install-docker-ubuntu.sh
  • Run the installation script
    ./install-docker-ubuntu.sh


  • Close and restart the Ubuntu window to make sure that the correct permissions for docker commands are enabled
  • Next step is to install Hummingbot by entering the following commands.
  • Download the necessary Hummingbot scripts:
    #Create script
    wget https://raw.githubusercontent.com/hummingbot/hummingbot/master/installation/docker-commands/create.sh
    #Start script
    wget https://raw.githubusercontent.com/hummingbot/hummingbot/master/installation/docker-commands/start.sh
    #Update script
    wget https://raw.githubusercontent.com/hummingbot/hummingbot/master/installation/docker-commands/update.sh
  • Enable script execution permission
    chmod a+x *.sh

Create and Run Hummingbot instances

  • We can start creating a Hummingbot instance by using the following command:
    ./create.sh
  • After following the prompts on the Create script, it should download and install Hummingbot and might take a few minutes.
  • Afterwards, you should be able to see the Welcome screen of Hummingbot
  • You can run the ./create.sh script every time you want to create a new Hummingbot instance or as many times needed

Navigating Docker Desktop

  • You can see all your Hummingbot instances under Containers / Apps


  • You can Stop, Start, Restart, Delete any of your Hummingbot Instance/s

That is all the steps you need to know in order for you install and run Hummingbot using Docker on Windows. Have fun!

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.