Skip to content

Offline Installation

For installing Botium Box on a server without public internet access, you have to upload the files manually to the server.

Installing Docker and Docker-Compose

It is possible to install Docker in offline mode by downloading a software package to your workstation, upload it to your server and run the package installer there.

For example, here are instructions how to do this on Ubuntu: https://docs.docker.com/engine/install/ubuntu/#install-from-a-package

For Docker Compose, you can download the binary to your workstation, and then upload it to your server. For Ubuntu, download the docker-compose binary to your workstation like this:

curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o docker-compose

For the exact version link see https://docs.docker.com/compose/install/

Upload the docker-compose file to the server, place it in /usr/local/bin/docker-compose and change access rights:

sudo chmod +x /usr/local/bin/docker-compose

Uploading Botium Box files and Docker images

Download the Botium Box files from this Github Repository to a workstation with internet access, upload it to the server and unpack it there.

Download the Botium Box Docker images to a workstation with internet access (replace the version tag with the actual Botium Box version):

docker pull botium/botium-box-server:2.8.2
docker save -o botium-box-server.tar botium/botium-box-server:2.8.2

docker pull botium/botium-box-agent:2.8.2
docker save -o botium-box-agent.tar botium/botium-box-agent:2.8.2

docker pull botium/botium-box-standalone:2.8.2
docker save -o botium-box-standalone.tar botium/botium-box-standalone:2.8.2

docker pull nginx
docker save -o nginx.tar nginx

docker pull botium/prisma:2.8.2
docker save -o prisma.tar botium/prisma:2.8.2

docker pull mysql:5.7
docker save -o mysql.tar mysql:5.7

docker pull phpmyadmin/phpmyadmin:latest
docker save -o phpmyadmin.tar phpmyadmin/phpmyadmin:latest

docker pull redis:alpine
docker save -o redis.tar redis:alpine

docker pull owasp/zap2docker-stable:latest
docker save -o zap.tar owasp/zap2docker-stable:latest

Copy all of the tar files to the server and import the Docker images:

docker load -i botium-box-server.tar
docker load -i botium-box-agent.tar
docker load -i botium-box-standalone.tar
docker load -i nginx.tar
docker load -i prisma.tar
docker load -i mysql.tar
docker load -i phpmyadmin.tar
docker load -i redis.tar
docker load -i zap.tar

Botium Box Installation Steps

Continue with the usual installation, now that the Docker images are available locally.