X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/d5fc6c1a22ea88bddc97ff4053ef53888ed82cd4..e9f9a63739cb79196ea0c231f09ab844f0665145:/doc/tips/dot_cgi.mdwn diff --git a/doc/tips/dot_cgi.mdwn b/doc/tips/dot_cgi.mdwn index e7fe7b2c8..dc88d9595 100644 --- a/doc/tips/dot_cgi.mdwn +++ b/doc/tips/dot_cgi.mdwn @@ -28,6 +28,10 @@ configuration changes should work anywhere. You may also want to install some dependencies to enable CGI in apache2 setup as: `libcgi-formbuilder-perl` and `libcgi-session-perl`. +* If your wiki is in `~/public_html` and does not appear when you enter the URL given by the installer, check that you have + the userdir mod enabled (there should be simlinks to userdir.load and userdir.conf in /etc/apache2/modes-enabled). If not, + run `a2enmod userdir` and reload apache2. + * You may also want to enable the [[plugins/404]] plugin. To make apache use it, the apache config file will need a further modification to make it use ikiwiki's CGI as the apache 404 handler. @@ -60,7 +64,7 @@ If you have any thought about it, feel free to let me know. ## nginx -To run CGI under nginx, just use a FastCGI wrapper like [this one](http://technotes.1000lines.net/?p=23). The wrapper must be started somehow just like any other FastCGI program. I use launchd on OSX. +To run CGI under nginx, you need to use a FastCGI wrapper. The wrapper must be started somehow just like any other FastCGI program. You can use launchd on OSX. In Linux, you will need the spawn-fcgi and fcgiwrap packages and start them with: @@ -68,7 +72,9 @@ them with: spawn-fcgi -s /tmp/fcgi.socket -n -- /usr/sbin/fcgiwrap This needs to be ran as your user. It can be added to `inittab` or -made into a startup script in `init.d`. +made into a startup script in `init.d`. You may also need to make this file writable by the webserver, if that's running as a different user, e.g.: + + chmod a+w /tmp/fcgi.socket Then you need an nginx config plugged in that wrapper. Here's an example virtual host configuration: @@ -95,6 +101,7 @@ example virtual host configuration: } } +Also, note that the `/tmp/fcgi.socket` file needs to be writable by the webserver. I am also unsure as to the security of this setup, as I am using this only on my dev server. Needless to say that [[real fastcgi support|todo/fastcgi_or_modperl_installation_instructions]] would be great. ;) --[[anarcat]] ## boa