For the experts, BB can also be run in a Docker container. For this guideline, it is assumed that you know what Docker is and how to use it. If you don’t know about Docker, this option is probably not for you.

Important: when using Docker, it is not possible to use the in-browser BB update function. The reason is that the application would be updated inside the Docker container, but whenever the container is restarted (e.g. after a crash, server restart, or manual stop/start), the originally installed BB version will again be used. Therefore, BB updates require some manual intervention in this scenario.

Every new BB release will be made available as a multi-platform Docker image on Docker Hub, supporting both AMD and ARM architectures. You can always get the most recent version by looking for the ‘latest’ tag. You can pull this image and use Docker to run it on any platform that has Docker installed.

To make it easier, you can use Docker Compose. Just download the following config file to your server:

Using this config file, Docker Compose will automatically pull the latest BB from Docker Hub. It will also set up the required port mapping and configure a volume to persist your bot data outside of the Docker container (otherwise the data will get lost if you start a new container).

Some hints:

  • Start BB: docker-compose up -d
  • Follow BB console output: docker-compose logs -f
  • Stop BB: docker-compose down
  • Update BB: docker-compose pull

Docker on Vultr

If you want to use Docker on Vultr, follow the following steps:

  • Install Docker: apt install
  • Install Docker Compose: apt install docker-compose
  • Enable the web firewall (if not done so already) – this is recommended as the UFW firewall on the VPS may cause issues
    • Add TCP on port 3000
    • This may take up to 2 minutes to get activated
  • Disable the UFW firewall: ufw disable
  • Download the docker-compose config file: wget
  • Start BB: docker-compose up -d