Merge branch 'master' into next
[ikiwiki] / doc / tips / lighttpd_cgi.mdwn
1 Here is how to enable cgi on [lighttpd](http://www.lighttpd.net/) and configure it in order to execute ikiwiki.cgi wherever it is located. 
2
3 * Activate cgi by linking `/etc/lighttpd/conf-available/10-cgi.conf` into `/etc/lighttpd/conf-enabled` ([doc](http://trac.lighttpd.net/trac/wiki/Docs%3AModCGI)). 
4
5 * Create `/etc/lighttpd/conf-available/90-ikiwiki-cgi.conf` and add a line like this:
6
7     cgi.assign = ( "ikiwiki.cgi"  => "", )
8
9 * Activate ikiwiki-cgi by linking `/etc/lighttpd/conf-available/90-ikiwiki-cgi.conf` into `/etc/lighttpd/conf-enabled`. 
10
11 * Restart lighttpd server with something like `/etc/init.d/lighttpd restart`.
12
13 Note that the first part enables cgi server wide but depending on default configuration, it may be not enough. The second part creates a specific rule that allow `ikiwiki.cgi` to be executed.
14
15 **Warning:** I only use this on my development server (offline). I am not sure of how secure this approach is. If you have any thought about it, feel free to let me know.