Mirror of the Rel4tion website/wiki source, view at <http://rel4tion.org>

[[ 🗃 ^yEzqv rel4tion-wiki ]] :: [📥 Inbox] [📤 Outbox] [🐤 Followers] [🤝 Collaborators] [🛠 Commits]

Clone

HTTPS: git clone https://vervis.peers.community/repos/yEzqv

SSH: git clone USERNAME@vervis.peers.community:yEzqv

Branches

Tags

master :: maint / admin /

ikiwiki.mdwn

[[!meta date=“2014-05-10”]]

This document will guide you through the process of setting up an online wiki using ikiwiki. Much of the instructions is general-purpose, but they are specifically written for use on Debian 7 stable with a Gitolite git server. The instructions also give hints to users of I2P and home server admins, and assume you followed the git server tutorial or at least have a similar setup.

Table of Contents

  1. [[!traillink Ikiwiki_Setup]]
  2. [[!traillink Git_Server]]
  3. [[!traillink Right_to_Left]]
  4. [[!traillink Summary]]
  5. [[!traillink Useful_Links]]

If you already somewhat familiar with these tools and just want a quick list of commands to run in order to setup the wiki, go to the Summary section. Otherwise, the information in the other sections supplies useful information.

Scenario

I assume you have a computer running Debiab 7 stable (current release at the time or writing is 7.5), and you want to run a wiki server on it. The wiki will be managed by ‘ikiwiki’, the flexible RCS-backed wiki compiler. I also assume you already have a git server of some sort: either you set up a new one for the wiki, or you already had one - possibly using Gitolite. Maybe you already have Gitweb served, which ikiwiki can use for comparing wiki page versions - if you don’t, you can check the git server tutorial for setup instructions.

Also, maybe you want to serve the wiki as an I2P eepsite, or a Tor hidden service. Or as an eepsite, a Tor hidden service and a regular clearnet website at the same time. This document doesn’t explain how to use them all together, but it gives hints fr I2P and Tor (I serve my wiki as an eepsite and also a Tor hidden service, but the links between pages are not modified, so it may not be the best way to do it).

There are tutorials on the web explaining how to configure Apache and Nginx for ikiwiki, but not much information for Lighttpd. I use lighttpd, and this document explains my configuration. It’s very simple, but I want to make sure it is documented on the web so everyone can use and enjoy it.

First we will see how to get ikiwiki running, and then begin to add features and get closer to the final working setup. We will also see how to use ikiwiki with gitolite, which is not difficult but probably not the most trivial setup. There’s a ikiwiki tip explaining the issue, but here it is covered in more depth, providing the exact commands for the suggested setup.

Convention: Command lines beginning with ‘$’ should be run by the specified user. If no user is specified, you can do them as your own user. Command lines beginning with ‘#’ should be run as root. You can use su to become root, or prefix these commands with sudo.

Let us begin.

Software Details

GNU/Linux distribution used: Debian 7 stable (release 7.5).

Package versions:

git................ 1:1.7.10.4-1+wheezy1
gitolite........... 2.3-1
lighttpd........... 1.4.31-4+deb7u2
gitweb............. 1:1.7.10.4-1+wheezy1
git-daemon-run..... 1:1.7.10.4-1+wheezy1
git-daemon-sysvinit 1:1.7.10.4-1+wheezy1
openssh-server..... 1:6.0p1-4
perl............... 5.14.2-21+deb7u1
I2P................ 0.9.12
ikiwiki............ 3.20120629
[See repo JSON]