From ecdd4c112a60c5fb22c781f142537e0b3399e568 Mon Sep 17 00:00:00 2001 From: ThePhaseless Date: Sat, 4 Jul 2026 18:24:54 +0200 Subject: [PATCH] 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 --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 81677d2..5e52141 100644 --- a/README.md +++ b/README.md @@ -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/)