How to Resolve Image Display Problems on Web?

🔷 For Fresh Installation Users

If you are starting your project fresh and images are not displaying:

• Follow the Fresh Installation steps (automatic or manual) from the documentation.
• If images still don’t display, set proper image permissions via your server terminal:

find . -type f -exec chmod 664 {} +
find . -type d -exec chmod 775 {} +

• This ensures all image files and directories are readable and writable by the system.
• After this, images should display correctly.

---

🔷 For Existing Users Updating Code to Version 2.0.0

If you updated your code and images are not displaying properly:

1. Verify Pre-Update Steps
Make sure you followed the Mandatory Pre-Update Guide:
Pre-Update Steps for Web

2. Run Database Migrations

php artisan migrate

Do not continue if this command fails.

3. Organize Existing Media Files

php artisan media:organize

• This migrates your old media files into the new media directory structure.
• After completing these steps, your images should display properly.

⚠️ Note: If images are still not displaying after following Step 3

1. Navigate to the public directory and rename the existing storage symlink to

storage-old

2. Recreate the storage symlink by running the following command:

php artisan storage:link

After completing these steps, the image storage link will be refreshed and images should display correctly.