in 
# Berkeley Open Infrastructure for Network Computing (BOINC)
# distributed computing client, system and platform
# run BOINC client in a docker container in Linux
# note this is *not* for GPU computing on Radeon or Nvidia video cards
# consult the online guide at https://hub.docker.com/r/boinc/client
# and at https://github.com/BOINC/boinc-client-docker for GPU computing
# more help is available from the official BOINC site at https://boinc.berkeley.edu
# this guide should work for all flavors and spins of Ubuntu 16 and later releases
# this also may work for flavors and spins of Debian 9 and later releases
# for best results, use Ubuntu 18 and later releases and have 2GB or more system RAM
# tested on Xubuntu 18 client 64bit and Ubuntu 18 server 64bit
# update repo lists
sudo apt update -y
# remove old versions and other installations of docker*
# could remove one package at a time if needed instead of all packages together
sudo apt remove -y docker docker-engine docker.io
# install docker engine from Ubuntu/Debian repo
# * or you may want to install docker engine called "docker-ce" from the official Docker repo
# * if you prefer "docker-ce" then don't install "docker.io"
# more info online 1 https://phoenixnap.com/kb/how-to-install-docker-on-ubuntu-18-04
# more info online 2 https://linuxconfig.org/how-to-install-docker-on-ubuntu-18-04-bionic-beaver
# more info online 3 https://wiki.debian.org/Docker
sudo apt install -y docker.io
# start and enable the docker engine service
sudo systemctl start docker
sudo systemctl enable docker
# verify that docker and containerd services are running
# both services are needed for docker to work right
sudo systemctl status docker
sudo systemctl status containerd
# get info about docker engine
sudo docker info
sudo docker version
# let a regular user "timmy" run docker commands by adding "timmy" to the 'docker' group
# and make the changes effective for the user "timmy" (without logging out)
sudo usermod -aG docker timmy
sudo -u timmy newgrp docker
# pull the official boinc image file from docker hub
# "sudo" command is not needed if you are "timmy" or another regular user who is in the 'docker' group
# more info online https://hub.docker.com/r/boinc/client
# more info online https://boinc.berkeley.edu/trac/wiki/BoincDocker
# more info online https://github.com/BOINC/boinc-client-docker
sudo docker pull boinc/client
# run a container instance of the boinc image file
# "sudo" command is not needed if you are "timmy" or another regular user who is in the 'docker' group
# can change BOINC_GUI_RPC_PASSWORD to another value, eight characters minimum for a password
# can change BOINC_REMOTE_HOST to another value for allowing incoming connections from other IP addresses
sudo docker run -d \
--name boinc \
--net=host \
--pid=host \
--restart always \
--log-opt max-size=10m \
-v /opt/appdata/boinc:/var/lib/boinc \
-e BOINC_GUI_RPC_PASSWORD="password" \
-e BOINC_CMD_LINE_OPTIONS="--allow_remote_gui_rpc" \
-e BOINC_REMOTE_HOST="127.0.0.1" boinc/client
# install a boinc manager, either GUI-based or text-based
# GUI-based
sudo apt install -y boinc-manager
# or text-based
sudo apt install -y boinctui
# if you install GUI based boinc-manager then boinc-client will also install
# we need to disable boinc-client because we won't use that
sudo systemctl stop boinc-client
sudo systemctl disable boinc-client
# run the local manager that you installed, and connect to localhost (127.0.0.1)
# you can also run a manager on a different (remote) network connected computer
# from a different (remote) computer, connect to IP address of the BOINC computer
# use value you supplied in BOINC_GUI_RPC_PASSWORD as the password.
# you can change the password later by editing a gui_rpc_auth.cfg file
# run boinccmd command-line tool from the docker boinc container to manage or manipulate boinc
# "sudo" command is not needed if you are "timmy" or another regular user who is in the 'docker' group
# replace <args> with arguments
sudo docker exec boinc boinccmd <args>
# example: get help for boinccmd
sudo docker exec boinc boinccmd --help
# example: get version of boinc client
sudo docker exec boinc boinccmd --client_version
# open a shell inside the docker boinc container
# and subsequently run other commands such as 'boinccmd' or 'ls'
# "sudo" command is not needed if you are "timmy" or another regular user who is in the 'docker' group
sudo docker exec -it boinc /bin/bash
# get a list and size of all running docker containers (containerized processes)
# "sudo" command is not needed if you are "timmy" or another regular user who is in the 'docker' group
sudo docker ps -s
# get statistics of all running docker containers
# "sudo" command is not needed if you are "timmy" or another regular user who is in the 'docker' group
sudo docker stats
# show all running docker processes by using "htop"
sudo apt install -y htop
htop -p $(pgrep docker)
# Happy computing and crunching 🤓