This update prevents the need to run containers with root privileges by
properly configuring user permissions.
Changes:
- Add user: "${UID:-1000}:${GID:-1000}" to docker-compose.yml
- Create .env file with UID/GID configuration
- Add .env.example template for users
- Update .gitignore to exclude downloads.old/
- Add comprehensive troubleshooting section in README.md
- Document 3 solutions for permission issues (recommended vs avoid)
- Explicitly warn against using user: root
This configuration works perfectly with Docker and Docker Compose.
For Podman rootless, additional step may be needed:
podman unshare chown -R 1000:1000 downloads/
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Raynoxis