[[WikkaDocumentation | Wikka Documentation]]
----
====Dreamhost and mod_rewrite====

>>**See also**
~-ModRewrite >>ModRewrite has great general instructions on how to get wikkawiki working with Apache's mod_rewrite, but if you run your wiki on Dreamhost's servers you will need to configure things a little differently.

===Configuration===
To get mod_rewrite working with Dreamhost you will need to create some .htaccess files. You will need to put these files into your wiki directory. You can either:
~1 SSH into your Dreamhost account and create the files directly on the server
~1 Create the files on your local computer and then FTP them to the appropriate directories

Step 1: the primary .htaccess file
In your top level wikkawiki directory create (or upload) the following file, be sure to name the file **.htaccess**:
%%
Options +Indexes +FollowSymLinks
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^(.*/[^\./]*[^/])$ $1/
RewriteRule ^(.*)$ wikka.php?wakka=$1 [QSA,L]
%%

Step 2: secondary .htaccess files
Now that mod_rewrite is turned on for the entire wiki, we need to turn it off where it isn't needed. So create (or upload) the following file (again name it **.htaccess**):
%%
RewriteEngine off
%%
into the following directories:
~3rdparty/plugins/freemind
~3rdparty/plugins/wikiedit
~css
~images

Step 3: let wikkawiki know
Modify the wikka.config.php file (back it up first) and change the 'base_url' and 'rewrite_mode' to:
%%
'base_url' => 'http://your.wikkawiki.domain/',
'rewrite_mode' => '1',
%%

----
CategoryDocumentation