If your Frappe site fails to load assets (e.g., CSS/JS), especially in production mode, try the following steps in order:
1. Restart Bench
If using Supervisor:
bench restart
If using manual bench start:
# Stop existing bench if running
ctrl + c
# Then restart
bench start
2. Clear Cache
Clear server-side and website caches:
bench --site [your-site] clear-cache
bench --site [your-site] clear-website-cache
3. Rebuild Frontend Assets
This is often necessary if the build is corrupted:
bench build --app frappe
Or rebuild the entire bench:
bench build --force
4. Browser Check
Try the following:
-
Use Incognito Mode
-
Clear browser cache
-
Use another browser
Sometimes old browser cache causes broken UI issues.
5. Pull Latest Code and Install Frontend Dependencies (that was my problem)
If you’re working with custom or development branches, it could be due to missing packages or broken asset links. Do the following:
cd apps/frappe
git pull upstream [your-frappe-branch]
yarn install
Then rebuild and restart:
bench build
bench restart
6. If you are in Production then don’t use root user
sudo chmod 755 /home/{YOURUSER}
replace {YOURUSER} with your actual Linux username
7. Reinstall App or Site (THIS IS NOT THE BEST SOLUTION)
Uninstall a broken app:
bench --site [your-site] uninstall-app [your-app]
Or drop and recreate the entire site:
bench drop-site [your-site]
bench new-site [your-site]
Backup your data before doing this.