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

Florian Treml
Dec 6, 2019 · 3 min read

Quick installation instructions for running Botium Box (all flavours) 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 port 4000 (for Botium Box Community Edition) or port 443 and 80 (for Professional/Enterprise/Unlimited Edition)

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.25.1-rc1/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

Launch Botium Box

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

Botium Box Community Edition

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-basic-dist.git
cd botium-box-basic-dist
echo -n my-license-key > resources/license.key
docker-compose up -d

Botium Box Professional/Enterprise/Unlimited Editions

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
echo -n my-license-key > resources/license.key
docker-compose up -d --scale agent=5

The last command will launch Botium Box with 5 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.

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store