[Quickstart] Install Hummingbot

Below, we show you how to easily install Hummingbot using our installation scripts for each supported platform. For more detailed instructions, refer to our User Manual.


For Linux we highlight the Docker image method for new users since it contains all necessary dependencies.

Step 1: Download helper scripts

We have created automated scripts that simplify the process of installing and running Hummingbot with Docker.

  • create.sh: Creates a new instance of Hummingbot
  • start.sh: Starts a stopped Hummingbot instance
  • update.sh: Updates Hummingbot

Copy the commands below and paste into your Linux terminal to download the scripts and enable permissions.

wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/install-docker/install-docker-ubuntu.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/create.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/update.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/start.sh
chmod a+x *.sh


Ensure the scripts have been downloaded by running ls -l command.


Step 2: Install Docker

Docker is an open source containerization product that pre-packages all dependencies into a single container, greatly simplifying the installation process. Execute the command below to install Docker using the script we downloaded in the previous step.


Close and restart your bash/terminal window to enable the correct permissions for the docker command. Otherwise, you may encounter an error in the next steps.

We also have instructions for installing Docker on Debian and CentOS.

Step 3: Install Hummingbot

Execute create.sh script which will help you install an instance of Hummingbot and set up folders to house your logs, configuration files and trades/orders database file.

hummingbot_files       # Default name of top level folder for hummingbot-related files
├── hummingbot_conf    # Maps to hummingbot's conf/ folder, which stores configuration files
├── hummingbot_logs    # Maps to hummingbot's logs/ folder, which stores log files
└── hummingbot_data    # Maps to hummingbot's data/ folder, which stores the SQLite database file

Run command to execute the script.


Follow the prompts to choose a version, give your Hummingbot instance a name, and enter the name of the folder where its files will be saved.


Afterwards, you should see the Hummingbot client interface. Proceed to Configure a Bot.

Windows and macOS

Setup and install package to install on local computer can be downloaded from our official website:

You may also refer to our User Manual for more information.

Hummingbot for Developers

For developers looking to contribute to Hummingbot and extend its capabilities, it is recommended to install Hummingbot from source.