WordPress Permalinks on Windows IIS

Thursday, November 12, 2009 @ 10:11 AM
admin

WordPress is written in PHP, and generally php runs better under apache on Linux, but you can run it on IIS on Windows machines. In fact this blog is running under Windows.*

If you find you have changed the permalinks options in your wordpress installation, but you find they don’t work,  first check if you are running on a Windows machine. On a shared hosting account, it should have said whether it was windows or linux, but at the least, if you have the option for asp.net, then you are on windows.

If you are on a Linux machine under apache, there are loads of resources for making sure permalink rewrites work. Running WordPress on windows however is much less common, so I thought I would post a quick fix for getting it to run under IIS7.

The trick involves adding a web.config file to your base installation. A web.config file is a configuration file used by Windows specifically for .net, but in this case if you are running wordpress you can trick IIS into passing the buck on files it can’t find to WordPress, that then handles it.

Simply ensure the URL Rewrite module is enabled on the IIS server (lots of hosts, including GoDaddy, have this enabled, but talk to your hosting company if it doesn’t), then add the following web.config file to the base of your WordPress installation.

web.config.txt

Note – windows prevents downloading anything with .config by default at the end, so download this file, remove the .txt at the end, then upload.

Good luck, and post comments if you still have problems!

* “Why the hell would you do that??” I hear you say! Generally web devs are fans of either languages made to run on proprietory systems (ASP.NET, Coldfusion etc) or open source Linux or Unix systems (php, ruby etc). Two reasons – It’s because I do both php (which runs on both) and ASP.NET dev, which only runs on Windows. To occasionally demonstrate some .net stuff on this blog, I need it to be on windows, or host it separately. Second, its using IIS7, which handles php almost as well as Apache. Linux and Windows fans – feel free to fight it out in the comments!
Like this? Share it!
  • Digg
  • del.icio.us
  • Facebook
  • DotNetKicks
  • email
  • Reddit
  • RSS
  • Slashdot
  • StumbleUpon
  • Technorati
  • Twitter
  • Yahoo! Buzz

55 Responses to “WordPress Permalinks on Windows IIS”

  1. This article is truly a fastidious one it helps new net visitors, who are wishing for blogging.

  2. Hi my family member! I wish to say that this article
    is awesome, great written and include almost all vital infos.

    I would like to look extra posts like this .

  3. Pk says:

    Thank You so much for this great help!!

  4. Matt says:

    Thanks for the post. I have linked to his from my site because I think it does a good job explaining the issue and gives an easy fix. While it didn’t fix it the problem for me it should fix it for others. I have found a work around that worked on my clients server and while permalink is slightly different in how it looks it is still better then post numbers. You can use the custom option and use use this: /index.php/%postname%/
    to achieve a similar workaround.

Leave a Reply

About Us

Global Artwork is a collection of contract web developers, designers, UX consultants and general webby people.

We have all worked together at various stages of our careers at the top of the industry, on some of the best clients. We don't wan't mainstream. You don't want mainstream. The web doesn't do mediocre - neither should you.

If you have an interesting project, swing by and ask us for advice.

more >>