uAdmin

Guides

Practical step-by-step instructions for developers and system administrators — installation, maintenance, PHP, projects and troubleshooting.

Diagnostics & troubleshooting

PHP-FPM not running

502 Bad Gateway, blank page — pool status, socket and service restart.

  1. Check service

    Web stack → Install shows php8.x-fpm service status. If stopped or failed, restart from panel or SSH.

    systemctl status php8.3-fpm
sudo systemctl restart php8.3-fpm

  2. Project pool

    Projects → project → Web → Pool. If pool missing, create it. If exists but fails, check pool file syntax in log.

  3. Recovery tool

    System maintenance or panel recovery offer stack service restart. SSH:

    sudo /usr/local/uadmin/bin/recovery-stack.sh restart
    Tip

    502 after apt upgrade often means php-fpm service stopped — restart fixes it.