docs(readme): add Proxmox OCI/LXC shm_size workaround

Adds the Docker Compose options from #283 (comment) that resolve
multiprocessing/camoufox FileNotFoundError errors on Proxmox OCI/LXC.

Closes #283
This commit is contained in:
ThePhaseless
2026-07-04 18:24:54 +02:00
parent 885a24cf16
commit ecdd4c112a
+14
View File
@@ -75,6 +75,20 @@ Once running, open:
1. If run successfully, try updating container or if already on newest stable release create an issue for creating new release with new dependencies
2. If build fails, try troubleshooting on another host/using other method
#### Proxmox OCI / LXC browser launch errors
If you are running Byparr as an OCI container in Proxmox (or another LXC-based setup) and see a `FileNotFoundError` from `multiprocessing.synchronize`/`camoufox` when processing requests, increase the service's shared memory in `compose.yaml`:
```yaml
services:
byparr:
shm_size: 512mb
stdin_open: true
tty: true
```
`shm_size: 512mb` is usually enough; `stdin_open` and `tty` are only needed if your orchestrator runs the container without a TTY.
### Local troubleshooting
1. Download [uv](https://docs.astral.sh/uv/getting-started/installation/)