Setup:

Ikiwiki is a bit harsh to understand. This schema helps a lot: https://ikiwiki.info/rcs/git/

So, basically, on the server there are 3 folders:

  • The repo, that is a bare git repo. Git users will pull and push there. If enabled in Ikiwiki and in the web server, the ikiwiki.cgi file will also push to that git repo, for changes made from the website. The repo lies at /root/repos/internal-ikiwiki.git
  • The srcdir, aka "source directory", that is a git clone of the aforementioned repo, from which Ikiwiki will take source files to build the website. It's in /home/internal/ikiwiki-srcdir
  • The destdir, aka "destination directory", where Ikiwiki will save the website HTML files after build. It's in '/var/www/internal.squat.net/and has a symlink at/home/internal/internal.squat.net`

Ikiwiki config happens in /home/internal/ikiwiki-srcdir/.ikiwiki/setup.ikiwiki

Instructions to build the wiki locally can be found here

Old notes that may be wrong On SkwotFarm it has been setup this way:

  • apt update && apt full-upgrade
  • apt install ikiwiki perlmagick
  • mkdir /var/www/internal.squat.net
  • cd /etc/apache2/sites-available
  • cp webstats.conf internal.squat.net.conf
  • vim internal.squat.net.conf (changed ServerName, DocumentRoot and deleted everything related to piwik/matamo)
  • a2ensite internal.squat.net.conf && systemctl reload apache2
  • echo "internal.squat.net" >> /etc/dehydrated/domains.txt
  • ikiwiki --setup /etc/ikiwiki/auto.setup
  • mv /root/internal-ikiwiki.git /root/repos/
  • mv /root/internal-ikiwiki/ /root/internal-ikiwiki-srcdir
  • mv /root/public_html/internal-ikiwiki /var/www/internal.squat.net
  • echo "root /root/internal-ikiwiki-srcdir/ikiwiki.setup" >> /root/.ikiwiki/wikilist After that, configuring ikiwiki itself is made in the git repo.