Fixing XenForo 404s: 'Requested page not found' Guide

The "Requested page not found" (404) error is one of the most common and frustrating issues XenForo administrators encounter, especially after a migration, server change, or initial setup. This guide details the primary causes and solutions to help you get your forum back online and fully accessible.

Understanding the XenForo 404 Error

A 404 error indicates that the server could not find the resource requested by the browser. In XenForo, this often points to a problem with how your server is handling URL rewrites, which are essential for friendly URLs.

Common Causes and Solutions

1. Incorrect or Missing .htaccess File

This is by far the most frequent culprit. XenForo relies on the .htaccess file (for Apache servers) to rewrite dynamic URLs into user-friendly ones (e.g., /forums/my-thread.123/ instead of /index.php?threads/my-thread.123/).

• Problem: The .htaccess file is missing from your forum's root directory, contains incorrect rules, or is not being read by Apache.
• Solution:

1. Verify Presence: Ensure a file named .htaccess exists in the root directory where index.php is located. If it's missing, create one.
2. Correct Content: The standard XenForo .htaccess content is crucial. Ensure it matches the following (or similar, depending on your XenForo version):

If your forum is in a subdirectory (e.g., public_html/forum/), uncomment RewriteBase / and change it to RewriteBase /forum/.

3. Server Configuration (AllowOverride): On Apache, the AllowOverride All directive must be set for your document root or virtual host configuration to allow .htaccess files to override server settings. If you manage your own server, check your httpd.conf or virtual host file. If you're on shared hosting, this is usually enabled, but you might need to contact support.

2. mod_rewrite Apache Module Not Enabled

XenForo's friendly URLs rely on Apache's mod_rewrite module. If this module isn't active, the server won't process the rewrite rules in .htaccess.

• Problem: mod_rewrite is disabled on your Apache server.
• Solution:

* Self-Managed Server: Enable it using a2enmod rewrite (Debian/Ubuntu) or by uncommenting LoadModule rewrite_module modules/mod_rewrite.so in your httpd.conf and restarting Apache.
* Shared Hosting: Contact your host and ask them to enable mod_rewrite.

3. Incorrect Board URL in config.php or Admin CP

XenForo needs to know its correct URL to generate links properly. If this is misconfigured, it can lead to broken links and 404s.

• Problem: The boardUrl setting is incorrect, especially after a domain change or migration.
• Solution:

1. Check src/config.php: Open src/config.php in your XenForo root. Look for $config['boardUrl']. Ensure it matches your forum's exact URL (e.g., https://www.example.com/ or https://www.example.com/forum/).
2. Admin Control Panel: If you can access the Admin CP, navigate to Setup > Options > Basic Board Information. Verify the "Board URL" field is correct.

4. File Permissions

While less common for direct 404s on pages, incorrect permissions can sometimes cause issues, particularly if XenForo can't write to its data or internal_data directories, leading to caching or routing problems.

• Problem: data or internal_data directories have incorrect permissions.
• Solution: Ensure the data and internal_data directories (and their subdirectories) have permissions set to 777 or 755 (depending on your server's suEXEC configuration, 755 is usually safer). Files within them should be 666 or 644.

5. Cache Issues

Sometimes, old cached routes can persist and cause problems.

• Problem: XenForo or server-side caching (like Cloudflare, Varnish) is serving outdated information.
• Solution:

1. XenForo Cache: If you can access the Admin CP, go to Tools > Rebuild Caches and run a "Rebuild master data" or "Rebuild all caches."
2. Server/CDN Cache: Clear any server-side cache (e.g., LiteSpeed cache, Varnish) or CDN cache (e.g., Cloudflare) that might be in front of your forum.

Troubleshooting Steps

1. Check Server Error Logs: Your web server's error_log (usually found in public_html, logs, or var/log/apache2) is your best friend. It often contains specific clues about why a rewrite rule failed or a file wasn't found.
2. Temporarily Disable Friendly URLs: If you can access your Admin CP, go to Setup > Options > Basic Board Information and uncheck "Use full friendly URLs." If your forum then becomes accessible via index.php?threads/..., it confirms the issue is with your .htaccess or mod_rewrite configuration.
3. Test .htaccess: Create a simple .htaccess file in your root with just RewriteEngine On and RewriteRule ^test.html$ index.php [L]. Then create an empty test.html file. If visiting yourdomain.com/test.html works, then .htaccess is being read. The issue is likely with the XenForo-specific rules.

By systematically checking these points, you should be able to diagnose and resolve most "Requested page not found" errors on your XenForo installation.