From 1b47ea8420ef937421eed2e99188c2db96d0d80f Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Sat, 19 Nov 2022 15:49:39 +0100
Subject: [PATCH] Added docker-compose for AMDGPU-enabled BOINC client

---
 docker/boinc-client/amdgpu.docker-compose.yml | 31 +++++++++++++++++++
 docker/boinc-client/pi.docker-compose.yml     |  8 +++++
 knowledge base/boinc.md                       |  6 ++++
 3 files changed, 45 insertions(+)
 create mode 100644 docker/boinc-client/amdgpu.docker-compose.yml

diff --git a/docker/boinc-client/amdgpu.docker-compose.yml b/docker/boinc-client/amdgpu.docker-compose.yml
new file mode 100644
index 0000000..2ab0dc8
--- /dev/null
+++ b/docker/boinc-client/amdgpu.docker-compose.yml
@@ -0,0 +1,31 @@
+# gotchas:
+# - 'pid: host' allows boinc to determine nonboinc processes for cpu percentages
+#   and exclusive applications
+# - 'group_add' removed in 3.0
+# - 'cpus' available from 2.2 and removed in 3.0
+#
+# sources:
+# - https://hub.docker.com/r/boinc/client
+# - https://docs.docker.com/compose/compose-file/compose-file-v2/
+
+version: '2.2'
+services:
+  client:
+    image: boinc/client:amd
+    container_name: boinc-client
+    restart: always
+    network_mode: host
+    pid: host
+    mem_swappiness: 1
+    group_add:
+      - video
+    devices:
+      - /dev/dri:/dev/dri
+      - /dev/kfd:/dev/kfd
+    volumes:
+      - ./data:/var/lib/boinc
+    environment:
+      - BOINC_CMD_LINE_OPTIONS=--allow_remote_gui_rpc
+      - BOINC_GUI_RPC_PASSWORD=123
+      - BOINC_REMOTE_HOST=192.168.1.1
+      - TZ=Europe/Dublin
diff --git a/docker/boinc-client/pi.docker-compose.yml b/docker/boinc-client/pi.docker-compose.yml
index f83dfb9..fd85d3c 100644
--- a/docker/boinc-client/pi.docker-compose.yml
+++ b/docker/boinc-client/pi.docker-compose.yml
@@ -1,3 +1,11 @@
+# gotchas:
+# - 'pid: host' allows boinc to determine nonboinc processes for cpu percentages
+#   and exclusive applications
+#
+# sources:
+# - https://hub.docker.com/r/boinc/client
+# - https://docs.docker.com/compose/compose-file/compose-file-v2/
+
 version: '2'
 services:
   client:
diff --git a/knowledge base/boinc.md b/knowledge base/boinc.md
index 4904a13..c308717 100644
--- a/knowledge base/boinc.md	
+++ b/knowledge base/boinc.md	
@@ -12,6 +12,9 @@
 # Install.
 flatpak install 'edu.berkeley.BOINC'
 sudo zypper install 'boinc-client' 'boinc-manager'
+
+# Set the GUI RPC communications port.
+boinc --gui_rpc_port 30000
 ```
 
 ## Client management
@@ -50,6 +53,7 @@ Oct 09 23:09:40 hostnameHere boinc[1709]: 09-Oct-2022 23:09:40 [---] OpenCL: AMD
 - [BOINC Manager]
 - [boinccmd]
 - [boinctui]
+- [GUI RPC bind to port 31416 failed: 98]
 
 <!-- internal references -->
 [boinccmd]: boinccmd.md
@@ -60,3 +64,5 @@ Oct 09 23:09:40 hostnameHere boinc[1709]: 09-Oct-2022 23:09:40 [---] OpenCL: AMD
 
 [amd linux drivers]: https://www.amd.com/en/support/linux-drivers
 [radeon™ software for linux® installation]: https://amdgpu-install.readthedocs.io/en/latest/
+
+[gui rpc bind to port 31416 failed: 98]: https://boinc.mundayweb.com/wiki/index.php?title=GUI_RPC_bind_to_port_31416_failed:_98