Rel4tion-Wiki/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