It's certainly no secret that the SARS-CoV-2 pandemic has changed everyone's lives in recent weeks. European countries are effectively closed, and people are more than ever being advised to self-isolate or work from home. It has put a tremendous amount of pressure on everyone.
Most of us at LinuxServer have now been mandated to work from home which has placed us in an entirely new working environment, closer to our families—primarily our spouses and children—providing us with new challenges! We are unable to dedicate as much time to volunteering on our support channels as we used to due to our days being turned upside-down. We don't all work in the IT industry either, with some of us in professions even more impacted by the pandemic. It's stressful. Hopefully those coming to us with queries on support for our images will understand that we may not be as responsive, or may be entirely unable to help until this thing blows over.
How you can help
Right now, scientists all over the planet are rushing to find new ways to protect us from a further outbreak of this virus. Using distributed computation, they are modelling various proteins in order to help them better understand how to create effective vaccines. This is where we all come in.
There are two large projects which allow people to run client programs on their own machines which share the computational workload of running complex tasks. Rather than having a single supercomputer crunching the numbers, tasks can be batched up and run simultaneously on thousands—or even millions—of machines at once. The great thing is we can install these clients on our home servers! And that's what we're asking you to do.
These projects are called Folding@home and BOINC, and are freely available for you to download and run on your own home machine. If you can spare the idle CPU on your NAS/PC/server, please consider running these clients to help speed up the process of finding an effective vaccine for COVID-19.
As always, we have provided a Docker image for both of these solutions which are outlined below. However, if you do not run Docker, each solution provides their own installer.
By creating a shared infrastructure for computational tasks, BOINC allows multiple kinds of projects to utilise distributed computing:
BOINC lets you help cutting-edge science research using your computer (Windows, Mac, Linux) or Android device. BOINC downloads scientific computing jobs to your computer and runs them invisibly in the background. It's easy and safe. About 30 science projects use BOINC; examples include Einstein@Home, IBM World Community Grid, and SETI@home. These projects investigate diseases, study global warming, discover pulsars, and do many other types of scientific research.
As this is a multi-project solution, to specifically target the research of COVID-19, add the Rosetta@home project to your BOINC installation.
boinc: image: linuxserver/boinc container_name: boinc environment: - PUID=1000 - PGID=1000 - TZ=Europe/London - GUAC_USER=boinc # Optional - GUAC_PASS=<MD5SUM_OF_YOUR_PASSWORD> # Optional volumes: - /path/to/data:/config ports: - 8080:8080 devices: - /dev/dri:/dev/dri #optional restart: unless-stopped
Considering this is a graphical tool, we are utilising our Apache Guacamole base image to give you graphical access to the client via a web browser. As optional layer of added security, you should provide the
GUAC_PASS environment variables in your command. In this case the password provided should be a pre-hashed MD5 sum. Do not worry if this in particular is a bit above your head; feel free to continue without the authentication for Guacamole.
Access the web UI via
Once started, you will need to add the Rosetta@home project via
Adding Rosetta@home to your install
In order to receive computational tasks, you will need to sign up to the Rosetta project. This way your progress can be tracked by its systems. You can also view the progress of your tasks on the Rosetta website as well as your BOINC client.
Once you have added the project, it will gather any updates and any tasks it needs to run. I would also highly recommend switching to the advanced view to better see the current task status:
You can also set up any computing preferences so that BOINC does not overuse or block your CPU when you need it for other tasks. These values can be as high or low as you wish—anything is better than nothing!
In the Tasks pane, you are then able to see the current status of your tasks: Task view of Rosetta@home
A similar solution to BOINC, operated by Stanford University:
Folding@home (FAH or F@h) is a distributed computing project for simulating protein dynamics, including the process of protein folding and the movements of proteins implicated in a variety of diseases. It brings together citizen scientists who volunteer to run simulations of protein dynamics on their personal computers. Insights from this data are helping scientists to better understand biology, and providing new opportunities for developing therapeutics.
Unlike BOINC, which allows you to add a multitude of projects, Folding@home has a singular purpose with a few different sub-types. In the case of COVID-19, the "Any" type prioritises this.
foldingathome: image: linuxserver/foldingathome container_name: foldingathome environment: - PUID=1000 - PGID=1000 - TZ=Europe/London volumes: - /path/to/data:/config ports: - 7396:7396 - 36330:36330 #optional restart: unless-stopped
You can access the web UI at
http://<server_ip>:7396 (try accessing it via an InPrivate/Incognito window if you're having issues with your browser cache).
The built-in web server provides a very basic control to get you up and running (i.e. GPUs are only active when set to
Medium or higher). For more fine grained control of individual devices, you can use the FAHControl app on a different device and connect remotely via port 36330. Bear in mind this is an unauthenticated connection.
If you wish to utilise your Nvidia GPU, you will need to install the container runtime provided by Nvidia on the host machine running the F@h container. Once nvidia-docker is installed on your host you will need to recreate the F@h container using the Nvidia container runtime instead (
--runtime=nvidia) also adding an extra environment variable to enable the relevant devices for passthrough:
-e NVIDIA_VISIBLE_DEVICES=all. This can also be set to a specific GPU's UUID, which can be discovered by running:
nvidia-smi --query-gpu=gpu_name,gpu_uuid --format=csv
Nvidia automatically mounts the GPU and drivers from your host into the Folding@home docker container. Our container has an environment variable set which ensures you are getting full use out of your GPU.
Don't forget to enter your user details into the web UI. When everything is set up and the work is downloaded from the servers, you should see the ongoing processes and the credits earned. Folding@home built-in web UI Now more than ever this is a time for everyone to come together to help prevent this kind of thing from happening again. It may seem innocuous now but doing something as simple as lending your CPU time for these projects does help.