Skip to content

Quick Installation Steps for Ubuntu Server 20.04

You need:

  • Plain Ubuntu Server 20.04

  • SSH access with default user “ubuntu” (or any other user with sudo permissions)

  • Port 80 opened for accessing Botium Box from clients

Install Docker and Docker Compose

curl -fsSL -o
sudo sh
sudo usermod -aG docker ubuntu

Log out and log in again to apply the new permissions. Afterwards:

docker info ### check user permissions
sudo curl -L`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version

Check for the latest download link.

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

Launch Botium Box

Download installation files and prepare folders:

git clone
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

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.

echo -n my-license-key > resources/license.key

And finally, launch Botium Box - at first start, Docker will download all of the required images, so it can take a while:

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.

Run this command to watch the output of the launch process:

docker-compose logs -f

Open Botium Box

Connect your browser to the Public DNS hostname or IP Address of your server instance