Skip to content


Folder structure

Hummingbot is local client software that you run on your own machine, so you have full control over how it’s configured and where you save your files. No one else can access your data and secrets!

Your Hummingbot folder contains the following folders:

    ┣ conf
        ┣ connectors
        ┣ strategies
        ┣ scripts
    ┣ logs
    ┣ data
    ┣ scripts
    ┣ hummingbot

Here is what each folder contains:

  • /conf: General folder for configuration files

  • /conf/connectors: Exchange API keys encrypted by your password

  • /conf/strategies: Strategy config files that you can create and import

  • /conf/scripts: Script config files that you can create --script-config

  • /logs: Log files generated by your scripts and strategies

  • /data: SQLite databases and CSV files for the trades executed by your scripts and strategies

  • /scripts: This folder contains the sample scripts, and you can add new scripts here to make them available to the start command

Launching Hummingbot


If you used Docker Compose to deploy Hummingbot, you can launch the network from the directory that contains the docker-compose.yml file with:

docker compose up -d

Then, attach to it (typically, the container name is hummingbot):

docker attach <container-name>


If you installed Hummingbot from source, make sure that the hummingbot conda environment has been activated before you run Hummingbot:

conda activate hummingbot

If you have made any changes, make sure to re-compile the code with ./compile to ensure that any changes to Cython files are compiled before running Hummingbot:


Afterwards, from the root directory, run this command:


Exiting Hummingbot

Running the exit command cancels all outstanding orders and exit the Hummingbot interface. In case of errors, the command exit -f will force the application to close.


You can also press the keyboard shortcut CTRL + C twice to exit.

Updating Hummingbot

Once a month, we publish an official release of Hummingbot and Hummingbot Gateway, marked by code release on Github and DockerHub and the publication of the release notes.

Subscribe to the Hummingbot Newletter to get notified when a new release ships.


Users of the Docker version of Hummingbot can update their instances to the latest image, which is updated with each release (e.g. hummingbot/hummingbot:latest).

See Useful Docker Commands for how to manage your containers. For example, you can update the Compose project for the latest images:

docker pull hummingbot/hummingbot


For users who have installed from source, they can update their Hummingbot branches to master (with every release) or development branch (updated continually):

git checkout [branch]
git pull origin [branch]

Keeping bots running in background


Press keys Ctrl + P then Ctrl + Q in sequence to detach from Docker, i.e., return to the command line. This exits out of Hummingbot without shutting down the container instance.

Use docker attach [container_name] to attach to an already-running bot in the background.


Use either tmux or screen to run multiple bots installed from source. Check out these external links how to use them.

When using screen to run an instance in the background, run either of the following commands: screen or screen -S $NAME, where $NAME is what you wish to call this background instance. Use the latter to be more explicit if you want to run multiple bots.

Navigate to the folder where your separate Hummingbot is installed, then start the bot like normal.

conda activate hummingbot

To exit the screen (detach), press Ctrl + A then Ctrl + D in sequence.

To list all running instances, use screen -ls.

List Screen Instances

Log back into the screen by using either screen or screen -r $NAME to open a specific instance.

Thank you to Discord user @matha for this question and @pfj for the solution!