From: AlexandreDupas <AlexandreDupas@web>
Date: Mon, 15 Sep 2008 15:29:57 +0000 (-0400)
Subject: Tips on configuring lighttpd to enable ikiwiki.cgi
X-Git-Tag: 2.65~116
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=2986f8f3c653cf99f56515e3b5e76f47923afae3;p=ikiwiki.git

Tips on configuring lighttpd to enable ikiwiki.cgi
---

diff --git a/doc/tips/lighttpd_cgi.mdwn b/doc/tips/lighttpd_cgi.mdwn
new file mode 100644
index 000000000..5504b0658
--- /dev/null
+++ b/doc/tips/lighttpd_cgi.mdwn
@@ -0,0 +1,15 @@
+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. 
+
+* 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)). 
+
+* Create `/etc/lighttpd/conf-available/90-ikiwiki-cgi.conf` and add a line like this:
+
+    cgi.assign = ( "ikiwiki.cgi"  => "", )
+
+* Activate ikiwiki-cgi by linking `/etc/lighttpd/conf-available/90-ikiwiki-cgi.conf` into `/etc/lighttpd/conf-enabled`. 
+
+* Restart lighttpd server with something like `/etc/init.d/lighttpd restart`.
+
+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.
+
+**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.