fix: App Store 500 Error

README.md

@@ -9,6 +9,7 @@ Using [NextCloud](https://nextcloud.com/)
   - [scan files](#scan-files)
   - [preview generator](#preview-generator)
   - [repair tree](#repair-tree)
+  - [Repair AppData Cache (Fix App Store 500 Error)](#repair-appdata-cache-fix-app-store-500-error)
   - [delete file locks](#delete-file-locks)
 - [Setup and Deploy](#setup-and-deploy)
   - [App](#app)
@@ -55,6 +56,28 @@ su -s /bin/bash www-data -c "./occ preview:generate-all --path=marcio.fernandes/
 su -s /bin/bash www-data -c "php occ files:repair-tree"
 ```
 
+### Repair AppData Cache (Fix App Store 500 Error)
+
+When the App Store returns HTTP 500, the cause is usually stale filecache entries pointing to missing files inside appdata_*.
+This procedure clears the broken cache and forces Nextcloud to rebuild it.
+
+```bash
+# Enable maintenance mode
+sudo -u www-data php occ maintenance:mode --on
+
+# Remove stale filecache entries (run inside MariaDB)
+mariadb -u root -p nextcloud -e "DELETE FROM oc_filecache WHERE path LIKE 'appdata_ocuihfjhxkga/appstore%';"
+
+# Remove corrupted appdata folder
+rm -rf /var/www/html/data/appdata_*
+
+# Disable maintenance mode
+sudo -u www-data php occ maintenance:mode --off
+
+# Rebuild appdata and caches
+sudo -u www-data php occ maintenance:repair
+```
+
 ### delete file locks
 
  ``` bash