Troubleshooting Common Errors
When things go wrong (and occasionally they will), don't panic! This guide will help you diagnose and fix the most common hosting issues.
The Golden Rules of Troubleshooting
Before diving into specific issues:
- Check the error logs - They usually tell you exactly what's wrong
- Think about what changed - Did you update something recently?
- Clear your cache - Both browser and server-side
- Try incognito mode - Rules out browser caching/extensions
- Check if it's just you - Use downforeveryoneorjustme.com
Website Errors
500 Internal Server Error
The catch-all "something's broken" error. Common causes:
PHP Error:
- Enable error display temporarily:
// In wp-config.php or at top of index.php
ini_set('display_errors', 1);
error_reporting(E_ALL);
- Check error logs for the specific error
- Fix the underlying PHP issue
Corrupted .htaccess:
- Rename
.htaccess to .htaccess.backup via File Manager
- If site works, your .htaccess was the problem
- Regenerate in WordPress: Settings > Permalinks > Save
.htaccess syntax error:
# This will cause 500 error:
RewriteEngine On
RewriteRule ^(.*)$ index.php [L # Missing bracket!
# Fixed:
RewriteRule ^(.*)$ index.php [L]
Permission issues:
# Fix directory permissions
find /home/user/public_html -type d -exec chmod 755 {} \;
# Fix file permissions
find /home/user/public_html -type f -exec chmod 644 {} \;
[SCREENSHOT: Error log showing a 500 error cause]
503 Service Unavailable
Server is overloaded or PHP workers exhausted.
Immediate fixes:
- Check if a cron job or process is consuming resources
- Kill runaway processes
- Wait for automatic recovery
Long-term fixes:
- Increase PHP-FPM workers
- Add caching (page cache, object cache)
- Optimise slow database queries
- Upgrade hosting plan
504 Gateway Timeout
Backend took too long to respond.
Causes:
- Slow database queries
- External API timeouts
- Heavy processing tasks
- Infinite loops in code
Fixes:
- Increase PHP
max_execution_time
- Optimise slow operations
- Add timeouts to external API calls
- Profile code to find bottlenecks
403 Forbidden
Access denied. Possible causes:
-
No index file:
- Create an
index.html or index.php
- Or enable directory listing (not recommended)
-
File permissions wrong:
chmod 644 filename.php
chmod 755 directory/
-
ModSecurity blocking:
- Check ModSecurity logs
- Whitelist if false positive
- Directory protection enabled:
- Check for
.htpasswd files
- Remove or update credentials
404 Not Found
The file or page doesn't exist.
For missing pages:
- Check the URL for typos
- Verify the file exists on server
- Check permalink settings (WordPress)
- Look for redirect rules that might interfere
For missing resources (CSS/JS/images):
- Check file paths in code
- Verify files were uploaded
- Check case sensitivity (Linux is case-sensitive!)
White Screen of Death (WSOD)
A blank white page, often in WordPress.
Quick fixes:
-
Increase PHP memory:
// wp-config.php
define('WP_MEMORY_LIMIT', '256M');
-
Enable debug mode:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', true);
-
Disable all plugins via FTP:
- Rename
/wp-content/plugins to /wp-content/plugins_disabled
- If site works, enable plugins one by one
- Switch to default theme:
- Rename your theme folder in
/wp-content/themes/
- WordPress will fall back to a default theme
Database Errors
"Error Establishing Database Connection"
The most feared WordPress error!
Check credentials:
- Open
wp-config.php
- Verify these match your database settings in Enhance:
define('DB_NAME', 'your_database');
define('DB_USER', 'your_username');
define('DB_PASSWORD', 'your_password');
define('DB_HOST', 'localhost');
Check database exists:
- Log into Enhance
- Go to Databases
- Verify the database is listed
Check user permissions:
- Ensure database user is assigned to the database
- Verify user has all necessary privileges
Repair database:
// Add to wp-config.php temporarily:
define('WP_ALLOW_REPAIR', true);
Then visit: yourdomain.com/wp-admin/maint/repair.php
[SCREENSHOT: Database configuration check in Enhance]
"MySQL Server Has Gone Away"
Connection dropped during query.
Causes:
- Query timeout
- Packet too large
- Server restart
Fixes:
- Increase
max_allowed_packet in MySQL config
- Optimise slow queries
- Check for server resource issues
"Too Many Connections"
Database connection limit reached.
Quick fixes:
- Restart MySQL/MariaDB (if you have access)
- Wait for connections to timeout
Permanent fixes:
- Use persistent database connections
- Implement connection pooling
- Optimise queries to be faster
- Increase connection limit - get in touch with us and we'll sort it
Email Issues
"Emails Not Sending"
Check SMTP settings:
- Verify server, port, username, password
- Common ports: 587 (TLS), 465 (SSL), 25 (unencrypted)
- Test with a simple script
Check mail logs:
tail -100 ~/logs/mail.log
WordPress-specific:
- Install WP Mail SMTP plugin
- Configure with your SMTP settings
- Use the test email feature
"Emails Going to Spam"
DNS checks:
- Verify SPF record exists and is correct
- Set up DKIM signing
- Configure DMARC policy
Test your email setup:
Content checks:
- Avoid spammy words ("FREE!!!", "Act Now")
- Include unsubscribe link for bulk emails
- Don't send from a new domain to many recipients
"Not Receiving Emails"
- Check MX records point to correct server
- Verify mailbox isn't full
- Check spam/junk folder
- Verify email forwarding isn't misconfigured
- Check for server-side filters
SSL/HTTPS Issues
"Your Connection Is Not Private"
Certificate expired:
- Renew certificate in Enhance
- Let's Encrypt should auto-renew; check for errors
Certificate mismatch:
- Verify certificate matches domain name
- Check for www vs non-www issues
- Verify all subdomains are covered
Mixed content:
# In .htaccess or nginx config:
# Force HTTPS
Mixed Content Warnings
HTTP resources loading on HTTPS page.
Finding mixed content:
- Open browser developer tools (F12)
- Look in Console for warnings
- Network tab shows blocked resources
Fixing in WordPress:
- Install "Better Search Replace" plugin
- Replace
http://yourdomain.com with https://yourdomain.com
- Update CDN URLs if applicable
SSL Certificate Won't Issue
Let's Encrypt troubleshooting:
-
DNS not propagated:
- Wait for propagation
- Verify A record with
dig yourdomain.com
-
CAA record blocking:
- Check CAA records
- Add
0 issue "letsencrypt.org" if needed
-
Rate limited:
- Let's Encrypt has rate limits
- Wait and retry, or use staging environment
- Port 80 blocked:
- HTTP validation requires port 80
- Check firewall rules
Performance Issues
Site Loading Slowly
Diagnose:
- Use GTmetrix, Pingdom, or PageSpeed Insights
- Check which resources are slow
- Monitor resource usage in Enhance
Common fixes:
- Enable caching
- Optimise images
- Use a CDN
- Minify CSS/JS
- Reduce plugin count
See our Performance Optimization Guide for details.
Database Queries Slow
- Check slow query log
- Add indexes to frequently searched columns
- Optimise queries
- Use object caching (Redis/Memcached)
Connectivity Issues
"Connection Timed Out"
Server-side:
- Check server is running
- Verify firewall isn't blocking
- Check resource usage
Client-side:
- Try different network
- Try different browser
- Check DNS resolution
Can't Connect via FTP/SSH
- Verify credentials
- Check port (22 for SSH/SFTP, 21 for FTP)
- Verify account is enabled
- Check if your IP is blocked
- Try different client
Emergency Recovery
Complete Site Recovery Checklist
- Don't panic - Breathe!
- Assess the situation - What's actually broken?
- Check backups - When was the last good backup?
- Review changes - What changed recently?
- Check logs - What do they say?
- Fix or restore - Either fix the issue or restore from backup
- Document - Note what went wrong and how you fixed it
- Prevent - Set up monitoring/alerts
When to Contact FXRM Support
Open a support ticket if you're experiencing:
- Server-level issues you can't access
- Suspected security breach
- Data loss without backup
- Persistent unexplained errors
- Hardware failures
When contacting us, please include:
- Domain name(s) affected
- Error messages (exact text or screenshots)
- When the issue started
- What you've already tried
- Recent changes made
Next Steps: Speed up your site with our Performance Optimization Guide.