Agent Screen Blank

What Causes This Error

The VICIdial agent interface displays a blank white or black screen. Causes include: VICIdial web server (Apache/Nginx) error, PHP processing error, database connection failure, browser JavaScript error, session timeout, or the agent’s IP being blocked by fail2ban after multiple login failures.

How to Fix It

• 1 Check browser console (F12) for JavaScript errors

• 2 Check Apache error log: sudo tail -50 /var/log/apache2/error.log

• 3 Check PHP errors: sudo tail -50 /var/log/php_errors.log

• 4 Check MySQL connection: mysql -u cron -ptest -e ‘SELECT 1’

• 5 Check if agent IP is blocked: sudo fail2ban-client status apache-auth

• 6 If blocked, unblock IP: sudo fail2ban-client set apache-auth unbanip AGENT_IP

• 7 Restart Apache if PHP processing is failing: sudo systemctl restart apache2

• 8 Have agent clear browser cache and try incognito mode

How to Prevent It

Implement uptime monitoring for the VICIdial web interface. Configure fail2ban whitelist for office IP ranges. Monitor Apache error logs daily. Keep browser recommendations documented for agents.

ViciStack’s free 30-day support plan includes unlimited live VICIdial troubleshooting. If you can’t resolve this error with the steps above, our engineers will connect to your system and fix it directly — no support tickets, no hourly billing.