Added docker-compose file and notes for boinc-client

This commit is contained in:
Michele Cereda
2022-05-11 22:42:09 +02:00
parent 7a3290815b
commit b13a3849c2
2 changed files with 66 additions and 0 deletions

View File

@@ -0,0 +1,51 @@
# Boinc client on Docker
## Parameters
Parameter | Type | Default | Function
--- | --- | --- | ---
`BOINC_CMD_LINE_OPTIONS` | Environment Variable | `"--allow_remote_gui_rpc"` | The `--allow_remote_gui_rpc` command-line option allows connecting to the client with any IP address. If you don't want that, you can remove this parameter, but you have to use the `BOINC_REMOTE_HOST="IP"` environment variable
`BOINC_GUI_RPC_PASSWORD` | Environment Variable | `"123"` | The password you will need to use when you connect to the BOINC client
`BOINC_REMOTE_HOST` | Environment Variable | `"127.0.0.1"` | (Optional) Replace the IP with your IP address. In this case you can connect to the client only from this IP
`TZ`| Environment Variable | `"Europe/London"` | (Optional) Specify a time zone. The default is UTC +0
`/opt/appdata/boinc:/var/lib/boinc` | Path or Volume | | The path where you wish BOINC to store its configuration data
`--pid=host` | Docker Run Option | | (Optional) Share the host's process namespace, basically allowing processes within the container to see all of the processes on the system. Allows boinc to determine nonboinc processes for CPU percentages and exclusive applications.
## Docker Compose
You can create the following docker-compose.yml file and from within the same directory run the client with docker-compose up -d to avoid the longer command from above.
```yaml
version: '2'
services:
boinc:
image: boinc/client
container_name: boinc
restart: always
network_mode: host
pid: host
volumes:
- /opt/appdata/boinc:/var/lib/boinc
environment:
- BOINC_GUI_RPC_PASSWORD=123
- BOINC_CMD_LINE_OPTIONS=--allow_remote_gui_rpc
```
## Attach to an account manager
```sh
boinccmd --acct_mgr attach https://bam.boincstats.com $USER $PASSWORD
```
## TODO
- automatic account manager attach after boot
## Sources
- [Github]
- [Docker Hub]
[docker hub]: https://hub.docker.com/r/boinc/client
[github]: https://github.com/BOINC/boinc-client-docker

View File

@@ -0,0 +1,15 @@
version: '2'
services:
client:
image: boinc/client:arm32v7
container_name: boinc-client
restart: always
network_mode: host
pid: host
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