FIX_PERMISSIONS.md

🔧 Permission Error Fix for Hugging Face Spaces

❌ Problem

PermissionError: [Errno 13] Permission denied: '/app/app/uploads'

✅ Solutions Applied

1. Updated Dockerfile

• Added non-root user for better security
• Created upload directories with proper permissions
• Added fallback to /tmp/uploads directory

2. Updated incidents.py Service

• Multiple fallback directory locations
• Graceful error handling for directory creation
• Logs directory creation attempts

3. Alternative Simple Dockerfile

Created Dockerfile.simple as backup if main one fails:

• Minimal setup without user switching
• Direct uvicorn command (no shell script)
• Uses /tmp/uploads (guaranteed writable)

🚀 Deploy Options

Option 1: Use Updated Dockerfile (Recommended)

The main Dockerfile now handles permissions properly.

Option 2: Use Simple Dockerfile

If still having issues, rename files:

mv Dockerfile Dockerfile.backup
mv Dockerfile.simple Dockerfile

Option 3: Manual Environment Variables

Set in HF Spaces environment:

UPLOAD_DIR=/tmp/uploads

🎯 Expected Result

• App should start successfully
• Upload directory will be created in /tmp/uploads if main location fails
• All functionality preserved with fallback handling

📊 Commit & Push

git add .
git commit -m "Fix permission errors for HF Spaces deployment"
git push

The deployment should now work on Hugging Face Spaces! 🎉