The Bot Libre Community Edition web platform is now available as a Docker container. This means that getting Bot Libre up and running on your server has never been easier!
What is Docker?
Docker is a platform that allows you to run “containers” using OS level virtualization. A container is a software package that is bundled with its required libraries and configuration, so you do not have to perform any additional configuration/installation yourself.
Software You Will Need:
- Installation instructions: https://docs.docker.com/engine/install/
- Check that Docker is working by using the following command:
- $ sudo docker version
- Docker Compose
- Installation instructions: https://docs.docker.com/compose/install/#install-compose
- Check that Compose is working by using the following command:
- $ sudo docker-compose version
Before starting up the server, make sure to set up your firewall correctly for Bot Libre.
Bot Libre Community Edition requires the following ports to be open:
- 80 – HTTP
- 443 – HTTPS
- 25 – SMTP
- 465 – SMTPS
- 110 – POP3
- 995 – POP3S
- 143 – IMAP
- 993 – IMAPS
- 6665 – IRC
The procedure for how to set up the firewall depends on the firewall you are using. For example, an Amazon EC2 instance would use security groups. For a typical Linux server, iptables can be used.
Deploying Bot Libre using Docker Compose:
First, you will need to download the docker-compose.yml file from our GitHub.
This can be done with the following command:
- $ wget https://raw.githubusercontent.com/BotLibre/BotLibre/master/botlibre-web/docker/docker-compose.yml
To build and create the containers for Bot Libre, run the following command:
- $ sudo docker-compose up --no-start
Running Bot Libre using Docker Compose:
To start the containers, run the following command:
- $ sudo docker-compose start
To gracefully stop the containers, run the following command:
- $ sudo docker-compose stop
To view the logs, run the following command:
- $ sudo docker-compose logs
If you need to run bash on the Tomcat web server container (app-web), first get the name of the container with this command:
- $ sudo docker ps
Then, use the following command with the container name:
- $ sudo docker exec -it container_name bash