This version of Instiki requires Ruby 1.8.6, 1.8.7 or 1.9.2 and Rubygems (1.3.6 or later). For instructions on using Instiki with some popular webhosting services, see here.
Ruby 1.8.7 and Rubygems come installed with the Developer Tools (an optional install, on your System Installation DVD) in MacOSX 10.5/10.6. In 10.7, Xcode is a $5 purchase from the App Store. Regardless, you do need the Developer tools installed, in order to set up Instiki. Do a
sudo gem update --system sudo gem update
See these instructions, to obtain the necessary prerequisites under Tiger.
On Debian and Ubuntu, you will need to:
$ sudo apt-get install ruby ruby1.8-dev libopenssl-ruby rake rubygems libsqlite3-ruby1.8 ri1.8 libxslt-dev libxml2-dev libsqlite3-dev swig flex bison
(Some of these don’t exist on my Ubuntu distro (meerkat): libopenssl-ruby, libxslt-dev (I have libxslt-ruby), libxml2-dev (I have libxml-dev).)
On Fedora, that would be:
$ yum install make ruby ruby-devel rubygems sqlite sqlite-devel swig flex bison
though, apparently, you may need to supply the necessary soft link
$ ln -s /usr/lib/libsqlite3.so.0.8.6 /usr/lib/libsqlite3.so
N.b.: If you get a
install_gem_spec_stubs': undefined method `loaded_specs' for Gem:Module (NoMethodError)
error, when you try to run Instiki, then the version of Rubygems that you installed is too old. See these instructions. In particular, you need to
sudo gem install rubygems-update sudo update_rubygems
to update Rubygems to a sufficiently recent version. (See the discussion here for more insight.)
The 1.8.7 and 1.9.2 RubyInstallers should get you the runtime prerequisites. Their Development kit provides the needed tools to install “native” Rubygems (like
itextomml). With either Ruby version it is strongly recommended that the entire path in which Instiki resides not contain any spaces in the directory names, as this will yield a warning message and potential problems.
Download and untar the latest release, or the current development version. The latter contains many bugfixes and improvements and is the version that is running on this site (so, if you can see this page, you know it’s working).
If you do opt for the development version, you can also get it using bzr:
bzr branch http://golem.ph.utexas.edu/~distler/code/instiki/svn/ location-of-Instiki/
git clone http://github.com/parasew/instiki.git location-of-Instiki/
Then further updates are as easy as doing a `bzr pull` (or
Make sure that there are no spaces in the pathname leading to the directory where you install Instiki (i.e., that none of the parent directories have spaces in their names).
Now, from the main instiki directory, type the command
ruby bundle install --path vendor/bundle
This will download and install the other prerequisites (the
will start up Instiki.
Point your web browser at
http://localhost:2500 and start configuring your first wiki!
It’s really that simple.
You can stop Instiki by issuing a
% kill pid-of-Instiki
There are various Commandline Options that you might want to play with.