X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/256dee00f9de872e52247ecad976edd97d70c5c8..41902cb9060787e798144fbaf12886e8d13fff25:/doc/tips/dot_cgi.mdwn diff --git a/doc/tips/dot_cgi.mdwn b/doc/tips/dot_cgi.mdwn index 9067fbea5..3fc404820 100644 --- a/doc/tips/dot_cgi.mdwn +++ b/doc/tips/dot_cgi.mdwn @@ -1,3 +1,5 @@ +[[!meta date="2009-01-12 20:01:03 -0500"]] + It's common to name the [[cgi]] "ikiwiki.cgi", and put it somewhere like `~/public_html/ikiwiki.cgi`, or `/var/www/wiki/ikiwiki.cgi`. @@ -13,9 +15,12 @@ run `.cgi` programs from anywhere. These instructions are for Debian systems, but the basic configuration changes should work anywhere. +[[!toc]] + ## apache 2 -* Make sure the cgi module is loaded. (Ie, `a2enmod cgi`) +* Make sure the cgi module is loaded. (Ie, `a2enmod cgi`). + Note that the cgid module will not work. * Edit /etc/apache2/apache2.conf (or /etc/apache2/mods-available/mime.conf) and add a line like this: @@ -77,6 +82,32 @@ made into a startup script in `init.d`. You may also need to make this file writ chmod a+w /tmp/fcgi.socket +If you have [systemd](https://en.wikipedia.org/wiki/Systemd), you may use a service file like so: + +Edit/create a service file (in Debian it would be: `sudo vim /lib/systemd/system/ikiwiki.service` + +Content of `ikiwiki.service`: + + [Unit] + Description=Ikiwiki fcgi socket wrap + After=network.target + + [Service] + Type=simple + User=www-data + Group=www-data + ExecStart=/usr/bin/spawn-fcgi -s /tmp/fcgi.socket -n -- /usr/sbin/fcgiwrap + + [Install] + WantedBy=multi-user.target + +Then run: + + # This enables the service at startup + sudo systemctl enable ikiwiki.service + # This attempts to start the service + sudo systemctl start ikiwiki.service + Then you need an nginx config plugged in that wrapper. Here's an example virtual host configuration: