/
Launch Hummingbot Miner

Linux

Ubuntu, Debian, CentOS and Source Installation Guide


You can install Docker and/or Hummingbot by selecting either of the following options from the tabs below:

  • Scripts: download and use automated install scripts.
  • Manual: run install commands manually.

Info: Recommended for Developers Only — Installation using Docker is more efficient for running Hummingbot. Installing from source is only recommended for developers who want to access and modify the software code.

Or prepare your development environment and get started developing for Hummingbot.

Ubuntu

Install via Docker

Supported versions: 16.04 LTS, 18.04 LTS, 19.04

  1. Install Docker

Skip this step if you already have Docker installed. Run the following commands:

# 1) Download Docker install script
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/install-docker/install-docker-ubuntu.sh

# 2) Enable script permissions
chmod a+x install-docker-ubuntu.sh

# 3) Run installation
./install-docker-ubuntu.sh

Warning: Please restart terminal — Close and restart your terminal window to enable the correct permissions for docker command before proceeding to next step.

  1. Install Hummingbot

Run the following commands:

# 1) Download Hummingbot install, start, and update script
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/create.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/start.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/update.sh

# 2) Enable script permissions
chmod a+x *.sh

# 3) Create a hummingbot instance
./create.sh

Install from Source

Supported versions: 16.04 LTS, 18.04 LTS, 19.04

# 1) Download install script
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/install-from-source/install-source-ubuntu.sh

# 2) Enable script permissions
chmod a+x install-source-ubuntu.sh

# 3) Run installation
./install-source-ubuntu.sh

After installing Hummingbot from source, see Start Hummingbot from source for instructions on how to start and run Hummingbot from source.

Debian

Install via Docker

Supported version: Debian GNU/Linux 9

  1. Install Docker

Skip this step if you already have Docker installed. Run the following commands:

# 1) Download Docker install script
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/install-docker/install-docker-debian.sh

# 2) Enable script permissions
chmod a+x install-docker-debian.sh

# 3) Run installation
./install-docker-debian.sh
> **Warning:** Please restart terminal — Close and restart your terminal window to enable the correct permissions for `docker` command before proceeding to next step.
  1. Install Hummingbot

Run the following commands:

# 1) Download Hummingbot install, start, and update script
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/create.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/start.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/update.sh

# 2) Enable script permissions
chmod a+x *.sh

# 3) Create a hummingbot instance
./create.sh

Install from Source

Supported version: Debian GNU/Linux 9

# 1) Download install script
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/install-from-source/install-source-debian.sh

# 2) Enable script permissions
chmod a+x install-source-debian.sh

# 3) Run installation
./install-source-debian.sh

After installing Hummingbot from source, see Start Hummingbot from source for instructions on how to start and run Hummingbot from source.

CentOS

Install via Docker

Supported version: 7

  1. Install Docker

Skip this step if you already have Docker installed. Run the following commands:

# 1) Download Docker install script
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/install-docker/install-docker-centos.sh

# 2) Enable script permissions
chmod a+x install-docker-centos.sh

# 3) Run installation
./install-docker-centos.sh

Warning Please restart terminal — Close and restart your terminal window to enable the correct permissions for docker command before proceeding to next step.

  1. Install Hummingbot

Run the following commands:

# 1) Download Hummingbot install, start, and update script
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/create.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/start.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/update.sh

# 2) Enable script permissions
chmod a+x *.sh

# 3) Create a hummingbot instance
./create.sh

Install from Source

Supported version: 7

# 1) Download install script
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/install-from-source/install-source-centos.sh

# 2) Enable script permissions
chmod a+x install-source-centos.sh

# 3) Run installation
./install-source-centos.sh

After installing Hummingbot from source, see Start Hummingbot from source for instructions on how to start and run Hummingbot from source.

Developer Notes

Edit on GitHub