Problem: CapRover's serviceUpdateOverride in captain-definition doesn't
always apply automatically, causing "Docker socket NOT found" errors.
Solution: Manual docker service update command to apply the mount.
Changes:
- Added CAPROVER_TROUBLESHOOTING.md with complete step-by-step fix
- Manual docker service update command
- Verification steps
- Common issues and solutions
- SELinux/AppArmor troubleshooting
- Created fix-caprover-docker-mount.sh automated script
- Finds service automatically
- Applies mount
- Verifies configuration
- Shows service status
- Enhanced backend/app.py diagnostics
- Lists /var/run directory contents
- Shows Docker-related files
- Better error messages explaining the issue
- Explicit note when mount is missing
- Updated backend/requirements.txt
- Docker SDK 7.0.0 -> 7.1.0 (fixes URL scheme error)
- Updated CAPROVER_DEPLOYMENT.md
- Prominent warning about serviceUpdateOverride limitation
- New Step 4: Verify and Apply Docker Socket Mount
- Quick fix command prominently displayed
- Links to troubleshooting guide
- Updated troubleshooting section with manual fix
- Updated QUICKSTART.md
- Warning after backend deployment instructions
- Quick fix command for both deployment options
- Links to troubleshooting guide
This provides users with immediate solutions when encountering the
"Cannot connect to Docker" error, which is now properly diagnosed
and can be fixed with a single command.
https://claude.ai/code/session_01NfGGGQ9Zn6ue7PRZpAoB2N