HI, if your UNA CMS install isn’t routing requests correctly (404 errors, service worker issues, blank pages), follow this checklist step by step:

Check Official Requirements

Verify that your server meets UNA’s requirements: 👉 UNA CMS Requirements Overview

Check Nginx & PHP-FPM Service Status

sudo systemctl status nginx
sudo nginx -t
sudo systemctl status php8.1-fpm

If any service isn’t running, restart them:

sudo systemctl restart nginx
sudo systemctl restart php8.1-fpm

Check Nginx Error Logs

sudo tail -n 100 /var/log/nginx/error.log

Look for errors like:

open() "/var/www/html/your/path" failed (2: No such file or directory)

Check PHP-FPM Logs

sudo tail -n 100 /var/log/php8.1-fpm.log

If you have custom pool configs, check those log paths too.

Verify Nginx Site Configuration

Ensure your Nginx config has the correct routing requests should fall back to index.php. Example config: 👉 UNA Docker Nginx Config Example

Check if you have correctly set UNA root in nginx config

cat /etc/nginx/sites-enabled/yoursite.conf

if it is not correct change it

vim /etc/nginx/sites-enabled/yoursite.conf

After any edits, reload Nginx:

sudo systemctl reload nginx

or

sudo service nginx reload

Clear UNA Cache

Inside your UNA directory:

sudo rm -rf ./cache/bx*
sudo rm -rf ./cache/db*
sudo rm -rf ./cache/lang*
sudo rm -rf ./cache_public/bx*
sudo rm -rf ./cache_public/less*

Then check:

ls cache
ls cache_public

Delete everything except .htaccess files.

Check UNA Logs

cd /path/to/una/
ls logs/
cat logs/any_una.log

Check File & Directory Permissions

Ensure the web server can write to essential folders:

so..

cd una

and then:

sudo chown -R www-data:www-data .
sudo find ./ -type d -exec chmod 755 {} \;
sudo find ./ -type f -exec chmod 644 {} \;
# Set execute permissions for ffmpeg.exe
sudo chmod +x ./plugins/ffmpeg/ffmpeg.exe

Check MySQL/MariaDB Logs

For MySQL:

sudo tail -n 100 /var/log/mysql/error.log

For MariaDB:

sudo tail -n 100 /var/log/mysql/mariadb.log

Look for errors like:

• Access denied for user 'una_user'@'localhost'
• Unknown database 'una_db'

Restart All Services

sudo systemctl restart nginx
sudo systemctl restart php8.1-fpm
sudo systemctl restart mysql

Important Note:

• Never post sensitive details like site URLs, usernames, or passwords publicly.
• If you're stuck, share your Nginx config and error log snippets (with personal info removed) for community help.

HAPPY CODING!