You have just completed the installation and configuration of your new WordPress blog–by the book. You proudly log into the dashboard and select a customized permalink (I use /%postname%/) and then hit the “Save Changes” button to save your configuration. Your blog now–goes crazy. When you try to access your blog, your browser returns nasty error pages instead of your blog’s content.
You recheck everything again, but can’t find any problem with your installation procedure. Using your FTP program or the WebShell utility at your web-host’s control panel, you verify that all of the necessary WordPress files and folders are in place and that the permissions are set correctly. In desperation, and using the control panel’s phpMyAdmin interface, you also verify that the MySQL database has been installed correctly and that the installer has configured the database tables. What could be wrong?
Before deleting your WordPress files and folders and zeroing out the database prior to trying a new installation, you grab a cup of your favorite beverage and relax a minute. You think about your installation. You remember that your new blog worked perfectly before you elected to change the permalink structure. Maybe it’s time to look at the server’s error log for the blog’s domain to see if it points to the root problem.
In the server’s error log, accessed from the web-host’s control panel, you notice the following error entry:
[Sun Mar 29 13:30:38 2009] [error] [client…] Options FollowSymLinks or SymLinksIfOwnerMatch is off which implies that RewriteRule directive is forbidden….
Bingo! Now you remember seeing something when you used your control panel to set up your blog’s domain. You log into your control panel and select the “Web options” icon. Right at the top of the options page you see that the “Symbolic Links” option is disabled. You enable and apply this option–and now the health of your blog is restored.
Well, almost restored. One nagging error continues to be recorded in the error log:
[Sun Mar 29 22:07:14 2009] [error] [client…] File does not exist:…/favicon.ico
When a browser accesses a web site, it always looks for a favicon.ico. WordPress does not install a favicon.ico by default. You need to either create your own or upload something suitable. Once the favicon.ico is uploaded into the blog’s root directory, this log error will disappear, too.
P.S. The Error log is your friend. Be sure to look at it from time to time.
Copyright © 2009 Royce Tivel at Select Digitals
When WordPress Permalinks Don’t Work, April 2, 2009