Tutorial: Install Botium Box on AWS (or any other cloud service)

UPDATE 2020/11/01: Botium’s free plan is live! With Botium Box Mini you will be able to:

  • use multiple chatbot technologies
  • set up test automation in a few minutes
  • enjoy a new improved user interface
  • get the benefits of a hosted, free service

Take it for a test drive

Quick installation instructions for running Botium Box on a bare bone AWS Linux server. Same principles apply for all other Linux servers.

Botium Box

Launch a Server Instance

Launch an AWS EC2 Instance with the latest Amazon Linux — take the first one in the Quick Start list.

See AWS docs for detailed steps, but it is basically just a click through.

  • Choose at least a t2.medium instance type if you really want to use Botium Box
  • Choose at least 50GB of disc space
  • In the security group, enable inbound ports 22 (for ssh) and 80 (for Botium Box HTTP)

Install Docker and Docker Compose

Connect to the AWS instance with SSH (most likely putty). Run these commands:

sudo yum update -y ### update yum database
sudo yum install -y git docker ### install git and docker
sudo service docker start ### start docker service
sudo systemctl enable docker ### make docker service auto start
sudo usermod -a -G docker ec2-user ### give user permissions

Then logout (close putty) and reconnect to make your user credentials reloaded.

docker info ### check user permissions
sudo curl -L https://github.com/docker/compose/releases/download/1.27.4/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose ### download and install docker-compose
sudo chmod +x /usr/local/bin/docker-compose ### give exec rights

Check https://docs.docker.com/compose/install/ for the latest download link.

Launch Botium Box

Docker and docker-compose are ready, now download and install Botium Box.

In the following script, replace my-license-key with the Botium Box license key (use copy&paste from the license.key file).

You can as well connect to your server with WinSCP and upload the license.key file instead of using echo.

git clone https://github.com/codeforequity-at/botium-box-premium-dist.git
cd botium-box-premium-dist
mkdir -p testsets && sudo chown -R 1000:1000 testsets
mkdir -p resources && sudo chown -R 1000:1000 resources
mkdir -p botiumwork && sudo chown -R 1000:1000 botiumwork
mkdir -p mysql && sudo chown -R 999:999 mysql
echo -n my-license-key > resources/license.key
docker-compose up -d --scale agent=2

The last command will launch Botium Box with 2 agents. Replace with the number of agents included in your license.

Open Botium Box

Connect your browser to the Public DNS hostname of your server instance (see server details)

First Steps

See the First Steps in Botium Box guide in Botium Wiki.

Co-Founder and CTO Botium🤓 — Guitarist 🎸 — 3xFather 🐣