- Joined
- Mar 22, 2026
- Messages
- 64
- Reaction score
- 0
iOS 18.6.0
Microsoft Edge 141
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
This is by far the most frequent culprit. XenForo relies on the
2. Correct Content: The standard XenForo
If your forum is in a subdirectory (e.g.,
3. Server Configuration (
2.
XenForo's friendly URLs rely on Apache's
* Shared Hosting: Contact your host and ask them to enable
3. Incorrect Board URL in
XenForo needs to know its correct URL to generate links properly. If this is misconfigured, it can lead to broken links and 404s.
2. Admin Control Panel: If you can access the Admin CP, navigate to
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
5. Cache Issues
Sometimes, old cached routes can persist and cause problems.
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
2. Temporarily Disable Friendly URLs: If you can access your Admin CP, go to
3. Test
By systematically checking these points, you should be able to diagnose and resolve most "Requested page not found" errors on your XenForo installation.
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 FileThis 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
.htaccessfile is missing from your forum's root directory, contains incorrect rules, or is not being read by Apache. - Solution:
.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):
Code:
apache
# Mod_rewrite in use.
RewriteEngine On
# If you are having problems with the rewrite rules, it is often the case that
# your "Default" or "FallbackResource" configuration needs to be manually
# configured in the .htaccess file.
# Many hosts use a configuration that will by default, send all requests
# to the index.php file (even if they don't exist).
# If this is the case, you can uncomment the following line and change
# the value to the correct filename (usually index.php).
#
# FallbackResource /index.php
# If you are having problems with the rewrite rules, it is often the case that
# your "RewriteBase" needs to be manually configured in the .htaccess file.
# If your XenForo installation is located in a subdirectory, change the
# value to the path to the XenForo installation relative to your document
# root.
#
# RewriteBase /
RewriteRule ^(.*)$ index.php [L]
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 EnabledXenForo'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_rewriteis disabled on your Apache server. - Solution:
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 CPXenForo needs to know its correct URL to generate links properly. If this is misconfigured, it can lead to broken links and 404s.
- Problem: The
boardUrlsetting is incorrect, especially after a domain change or migration. - Solution:
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:
dataorinternal_datadirectories have incorrect permissions. - Solution: Ensure the
dataandinternal_datadirectories (and their subdirectories) have permissions set to777or755(depending on your server's suEXEC configuration,755is usually safer). Files within them should be666or644.
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:
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.
