Ikiwiki

This page is here to share my experiences with ikiwiki after having worked with it for the everything magazine archive together with Simon and/for Steve.

Notes

We took notes while working on this project here: https://hub.xpub.nl/rushtonhosts/everything-magazine-archive/backstage/

Server configs

This is a trace down of the config files of the everything ikiwiki.

I can't remember which source i followed to set it up, or where i learned from, but i think it was the official ikiwiki documentation. And i remember it was quite a struggle. Specially the fastcgi part!

nginx

/etc/nginx/sites-enabled/default

        # Enable CGI for ikiwiki
        location ~ \.cgi$ {
                auth_basic "If you are the lucky winner of the password quiz, please complete the rubric below.";
                auth_basic_user_file /etc/apache2/.htpasswd;
                gzip off;
                fastcgi_pass unix:/var/run/fcgiwrap.socket;
                include fastcgi_params;
        }

ikiwiki-cgi.service

/etc/systemd/system/ikiwiki-cgi.service

[Unit]
Description=Ikiwiki fcgi socket wrap
After=network.target

[Service]
Type=simple
User=ikiwiki
Group=www-data
ExecStart=/usr/bin/spawn-fcgi -s /var/run/fcgi.socket -n -- /usr/sbin/fcgiwrap

[Install]
WantedBy=multi-user.target

fcgiwrap.service

/lib/systemd/system/fcgiwrap.service

(but i think this was generated automatically, i did not touch it!)

[Unit]
Description=Simple CGI Server
After=nss-user-lookup.target
Requires=fcgiwrap.socket

[Service]
Environment=DAEMON_OPTS=-f
EnvironmentFile=-/etc/default/fcgiwrap
ExecStart=/usr/sbin/fcgiwrap ${DAEMON_OPTS}
User=www-data
Group=www-data

[Install]
Also=fcgiwrap.socket

fastcgi.conf

/etc/nginx/fastcgi.conf

I found these lines commented out in this file, so i guess i tried something here, but it was not needed in the end.

# Added for rushtonhosts
# fastcgi_param  DOCUMENT_ROOT      /rushtonhosts/
# fastcgi_param  SCRIPT_FILENAME    /rushtonhosts/$fastcgi_script_name;;