Instiki
Installation

1. General Prerequisites

This version of Instiki requires

1. Ruby 1.8.5 (or higher). N.B.: Rails in not currently compatible with Ruby 1.9. Hence, neither is Instiki. Stick with Ruby 1.8.x.
2. SWIG
3. The sqlite3 Ruby bindings

MacOSX

Leopard

All these prerequisites come installed with MacOSX 10.5. You can skip to the next step.

Tiger

Under MacOSX 10.4, the easiest way to obtain the prerequisites is using Fink. (Be sure you have unstable/main in your list of Fink trees. )

% fink install ruby ruby18-dev rubygems-rb18 sqlite3-rb18 swig

An alternative (that will get you everything but SWIG is the rubyosx installer).

Once you’ve installed these prerequisites, you can proceed to the next step of the installation.

N.B.: On some Tiger systems, Ruby, as installed by either of these methods, is prone to Segmentation Faults. If that happens to you, you’ll need to back up to this point and follow the instructions in this blog post.

Linux

On Debian testing and Ubuntu Edgy, you will need (at least) ruby, ruby1.8-dev, rubygems, swig, libsqlite3-ruby1.8, flex and bison:

$ sudo apt-get install ruby ruby1.8-dev rubygems swig libsqlite3-ruby1.8 flex bison

On Fedora, I’m told that

$ yum install ruby rubygems sqlite swig flex bison

suffices to get you the necessary prerequisites, though apparently you may need to supply the necessary soft link

$ ln -s libsqlite3.so.0.8.6  libsqlite3.so

yourself.

Windows

There’s a one-click Ruby Installer, which should get you most of the prerequisites. I don’t think it gets you SWIG, nor the compiler tools necessary to install the itex2MML Ruby bindings.

2. Installing the itex2MML Ruby Bindings

Download and untar the itex2MML distribution. Then

% cd itexToMML/itex-src
% make ruby
% make test_ruby
% sudo make install_ruby

Building on Shared Hosts

For instructions on building itex2MML and installing Instiki in shared web hosting environments without access to a compiler, see Installing on Shared Hosts.

Installing Under Windows

CygWin

You’ll need CygWin and the following CygWin packages: bison, flex, gcc-core, gcc-g++, make and swig.

3. Installing Instiki

Download and untar my Instiki distribution. Or, alternatively, use bzr to obtain the latest version. Then

% cd instiki-svn
% ./instiki --daemon

Point your web browser at http://localhost:2500 and start configuring your first wiki! (Be sure to select the “Markdown+itex2MML” filter, which is the default setting for this branch of Instiki.)

It’s really that simple.

4. Care and Feeding

You can stop Instiki by issuing a

% kill pid-of-Instiki

For tips on the day-to-day running of Instiki, see the Housekeeping page. For tips on security considerations, see the Security page.