paul/picpeak
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

docs: add PUID/PGID note for Docker bind mounts to avoid permission issues
Mirror to GitHub / mirror (push) Successful in 40s
Details
Test and Lint / backend-test (push) Successful in 1m31s
Details
Test and Lint / frontend-test (push) Successful in 2m16s
Details

Browse Source
This commit is contained in:
paul
2025-09-14 16:10:12 +02:00
parent aa9b3a0227
commit 0178e71c67
1 changed files with 8 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+8
View File
@@ -72,6 +72,14 @@ docker-compose up -d
# Access at http://localhost:3005 # Access at http://localhost:3005
``` ```
Note on Docker file permissions (PUID/PGID)
- When using bind mounts (e.g., `./storage`, `./data`, `./logs`, `./events`), ensure the container user can write to these host folders. The backend runs as a non‑root user by default.
- Set `PUID` and `PGID` in your `.env` to match your host user’s UID/GID (run `id -u` and `id -g` on the host). Compose maps the container user to these values.
- Example in `.env`:
- `PUID=1000`
- `PGID=1000`
- Without this, creating events, uploads, thumbnails, or logs can fail with “Permission denied”.
## 📖 Documentation ## 📖 Documentation
- 📘 [**Deployment Guide**](DEPLOYMENT_GUIDE.md) - Detailed installation instructions - 📘 [**Deployment Guide**](DEPLOYMENT_GUIDE.md) - Detailed installation instructions