Web Interface Issues¶

Troubleshooting guide for web interface problems.

Quick Checks¶

# Check services
sudo systemctl status nginx
sudo systemctl status php8.2-fpm
sudo systemctl status mb-rpcd

# Check logs
sudo tail -n 50 /var/log/nginx/mailborder-error.log
sudo tail -n 50 /var/log/php8.2-fpm.log

Cannot Access Interface¶

Check Nginx:

sudo systemctl status nginx
sudo nginx -t  # Test configuration

Check SSL certificate:

sudo ls -lh /etc/ssl/certs/mailborder.crt
sudo ls -lh /etc/ssl/private/mailborder.key

Test from command line:

curl -I https://mailborder.example.com

502 Bad Gateway¶

Cause: PHP-FPM or mb-rpcd not running

Check PHP-FPM:

sudo systemctl status php8.2-fpm
sudo ls -lh /var/run/php/mailborder.sock

Check mb-rpcd:

sudo systemctl status mb-rpcd

Restart:

sudo systemctl restart php8.2-fpm
sudo systemctl restart mb-rpcd
sudo systemctl reload nginx

500 Internal Server Error¶

Check logs:

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

Common causes: - PHP errors - Database connection failure - Permission issues

Fix permissions:

sudo chown -R www-data:www-data /srv/mailborder/master/
sudo chmod -R 755 /srv/mailborder/master/

Check authentication:

sudo tail -f /var/log/mailborder/auth.log

Test user exists:

sudo mb-admin-list | grep user@example.com

Reset password:

sudo mb-admin-reset --email user@example.com

Session Expired Immediately¶

Check Redis:

redis-cli ping

Check session configuration:

sudo cat /etc/php/8.2/fpm/pool.d/mailborder.conf | grep session

Restart services:

sudo systemctl restart redis-server
sudo systemctl restart php8.2-fpm

Slow Interface¶

Check resource usage:

top
free -m

Check database:

sudo mysql -u mailborder -p mailborder -e "SHOW PROCESSLIST"

Optimize:

# Increase PHP workers
sudo nano /etc/php/8.2/fpm/pool.d/mailborder.conf
# pm.max_children = 50

sudo systemctl restart php8.2-fpm