Docker builds

Getting started

Installing docker

Install docker with your package manager like apt, brew, pacman, etc like pacman -S docker docker-compose

Before You Begin

Install Docker Engine + CLI tools
Enable Linux permissions
Allocate 4GB+ disk space for images

Building images

Use the docker make targets like make docker-server-debug for building docker images.This will build a image with name like bombsquad_server_debug.

Loading downloaded image

Download latest image here
Unzip to get the tar file
Load it with docker load < bombsquad_docker_gui.tar

Running containers

We can check the name of images with docker images and run them with docker run -it bombsquad_server_debug

GUI builds

First we modify the X server's access control list to permit connections from Docker containers with xhost +local:docker to allow docker to access the display and then

BS_IMAGE_NAME=bombsquad_gui_debug \
                 docker compose \
                 -f config/docker/docker-compose.yml \
                 run bombsquad_gui

OR

docker run -it -e DISPLAY=$DISPLAY \
                 -e PULSE_SERVER=unix:/run/user/1000/pulse/native \
                 -v /tmp/.X11-unix:/tmp/.X11-unix \
                 -v /run/user/1000/pulse:/run/user/1000/pulse \
                 -v ~/.ballisticakit/:/root/.ballisticakit \
                 --privileged=true --device /dev/snd:/dev/snd \
                 bombsquad_gui_debug

Build Options Comparison

Method	Command	Best For
Makefile	`make docker-server-debug`	Quick builds
Manual	`docker build -t bombsquad_gui_debug -f config/docker/Dockerfile .`	Custom configurations
Compose	`BS_IMAGE_NAME=bombsquad_gui_debug docker compose -f config/docker/docker-compose.yml build bombsquad_gui`	Simple preset configurations