build(docker): fixed folder permissions issues for logs and cache in docker

Author: mubbi

containers/docker-compose.yml

@@ -16,8 +16,6 @@ services:
       - ./php/php.ini:/usr/local/etc/php/conf.d/custom.ini
       - ./php/xdebug.ini:/usr/local/etc/php/conf.d/xdebug.ini
       - ./nginx/default.conf:/etc/nginx/sites-available/default
-      - laravel_logs:/var/www/html/storage/logs
-      - laravel_cache:/var/www/html/bootstrap/cache
     ports:
       - "8081:80"
       - "8001:8001" # xdebug port
@@ -129,7 +127,3 @@ volumes:
     driver: local
   redis_data:
     driver: local
-  laravel_logs:
-    driver: local
-  laravel_cache:
-    driver: local

containers/fix-permissions.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+
+echo "🔧 Quick permission fix for Laravel storage directories..."
+
+# This script can be run inside the container to fix permissions
+# Usage: docker exec -it laravel_blog_api /usr/local/bin/fix-permissions.sh
+
+# Fix ownership
+echo "📁 Fixing ownership..."
+chown -R www-data:www-data /var/www/html/storage 2>/dev/null || true
+chown -R www-data:www-data /var/www/html/bootstrap/cache 2>/dev/null || true
+
+# Fix permissions
+echo "🔐 Fixing permissions..."
+chmod -R 775 /var/www/html/storage 2>/dev/null || true
+chmod -R 775 /var/www/html/bootstrap/cache 2>/dev/null || true
+chmod -R 775 /var/www/html/storage/logs 2>/dev/null || true
+chmod -R 775 /var/www/html/storage/framework 2>/dev/null || true
+chmod -R 775 /var/www/html/storage/app 2>/dev/null || true
+
+# Make artisan executable
+chmod +x /var/www/html/artisan 2>/dev/null || true
+
+echo "✅ Permissions fixed!"
+echo "📋 Current storage permissions:"
+ls -la /var/www/html/storage/logs/ 2>/dev/null || echo "Logs directory not accessible"

containers/php/Dockerfile

@@ -67,9 +67,11 @@ COPY supervisor/supervisord.conf /etc/supervisor/conf.d/supervisord.conf
 COPY start-services.sh /usr/local/bin/start-services.sh
 COPY start-main-app.sh /usr/local/bin/start-main-app.sh
 COPY start-queue-worker.sh /usr/local/bin/start-queue-worker.sh
+COPY fix-permissions.sh /usr/local/bin/fix-permissions.sh
 RUN chmod +x /usr/local/bin/start-services.sh
 RUN chmod +x /usr/local/bin/start-main-app.sh
 RUN chmod +x /usr/local/bin/start-queue-worker.sh
+RUN chmod +x /usr/local/bin/fix-permissions.sh
 
 # Create necessary Laravel directories and set proper permissions
 RUN mkdir -p /var/www/html/storage/app/public \

containers/start-main-app.sh

@@ -18,22 +18,9 @@ trap shutdown SIGTERM SIGINT
 # Remove any existing ready marker
 rm -f /var/www/html/storage/laravel_ready
 
-# Universal permission fix for all systems
+# Fix permissions at startup
 echo "[MAIN] SETUP: Fixing Laravel directory permissions..."
-# Ensure www-data user owns all files (www-data is standard across systems)
-chown -R www-data:www-data /var/www/html 2>/dev/null || true
-# Set proper permissions for storage and cache directories
-chmod -R 775 /var/www/html/storage 2>/dev/null || true
-chmod -R 775 /var/www/html/bootstrap/cache 2>/dev/null || true
-# Ensure specific subdirectories have correct permissions
-chmod -R 775 /var/www/html/storage/framework/cache 2>/dev/null || true
-chmod -R 775 /var/www/html/storage/framework/sessions 2>/dev/null || true
-chmod -R 775 /var/www/html/storage/framework/testing 2>/dev/null || true
-chmod -R 775 /var/www/html/storage/framework/views 2>/dev/null || true
-chmod -R 775 /var/www/html/storage/logs 2>/dev/null || true
-chmod -R 775 /var/www/html/storage/app 2>/dev/null || true
-# Make artisan executable
-chmod +x /var/www/html/artisan 2>/dev/null || true
+/usr/local/bin/fix-permissions.sh
 
 # Wait for database to be ready
 echo "[MAIN] WAITING: Database connection..."
@@ -96,12 +83,9 @@ php artisan config:clear
 php artisan config:cache
 php artisan route:cache
 
-# Universal permission fix after optimization
+# Fix permissions after optimization
 echo "[MAIN] SETUP: Fixing permissions after optimization..."
-chown -R www-data:www-data /var/www/html/storage 2>/dev/null || true
-chown -R www-data:www-data /var/www/html/bootstrap/cache 2>/dev/null || true
-chmod -R 775 /var/www/html/storage 2>/dev/null || true
-chmod -R 775 /var/www/html/bootstrap/cache 2>/dev/null || true
+/usr/local/bin/fix-permissions.sh
 
 # Create ready marker to signal that the app is fully set up
 echo "[MAIN] SUCCESS: Application setup complete! Creating ready marker..."

containers/start-queue-worker.sh

@@ -1,5 +1,11 @@
 #!/bin/bash
 
+echo "[QUEUE] Starting Laravel queue worker..."
+
+# Fix permissions at startup
+echo "[QUEUE] SETUP: Fixing Laravel directory permissions..."
+/usr/local/bin/fix-permissions.sh
+
 echo "[QUEUE] Waiting for main Laravel application to be ready..."
 
 # Function to check if main application is ready