From 275542b6ee09059ff7fed8270664c22a27136b14 Mon Sep 17 00:00:00 2001
From: Bram <info@bramkelchtermans.be>
Date: Wed, 2 Jul 2025 10:05:48 +0200
Subject: [PATCH] Update puppeteer healthcheck Dockerfile to run as root for
 Docker socket access and enhance README with common error resolution steps.

---
 Dockers/puppeteer-healthcheck/Dockerfile |  3 ++-
 Dockers/puppeteer-healthcheck/README.md  | 18 ++++++++++++++++++
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/Dockers/puppeteer-healthcheck/Dockerfile b/Dockers/puppeteer-healthcheck/Dockerfile
index 4c637ef..d4f0442 100644
--- a/Dockers/puppeteer-healthcheck/Dockerfile
+++ b/Dockers/puppeteer-healthcheck/Dockerfile
@@ -29,7 +29,8 @@ RUN groupadd -g 999 docker || true && \
     useradd -r -g docker -u 999 healthcheck && \
     chown -R healthcheck:docker /app
 
-USER healthcheck
+# Don't switch user - run as root for Docker socket access
+# USER healthcheck
 
 # Run the healthcheck script
 CMD ["python", "healthcheck.py"]
\ No newline at end of file
diff --git a/Dockers/puppeteer-healthcheck/README.md b/Dockers/puppeteer-healthcheck/README.md
index 86df023..9162662 100644
--- a/Dockers/puppeteer-healthcheck/README.md
+++ b/Dockers/puppeteer-healthcheck/README.md
@@ -110,6 +110,24 @@ If you see "Permission denied" errors when accessing the Docker socket:
    docker run --user root ...
    ```
 
+### Common Error: "Connection aborted. PermissionError(13, 'Permission denied')"
+
+This error occurs when the container cannot access the Docker socket. To fix:
+
+1. **Mount the Docker socket**:
+
+   ```bash
+   -v /var/run/docker.sock:/var/run/docker.sock:ro
+   ```
+
+2. **Add the container to the docker group**:
+
+   ```bash
+   --group-add $(getent group docker | cut -d: -f3)
+   ```
+
+3. **Use the provided docker-compose.yml** which includes all necessary configurations.
+
 ### Container not found
 
 - Ensure the `TARGET_CONTAINER` environment variable matches the exact name of your puppeteer-api container