1242931334|%e %B %Y
tags: debian git github installation packages simple ubuntu
Currently, Wikidot software is meant as just a wiki engine. "Just", because it used to be a complete wiki farm solution. Actually it's kind of both, but from start you get just a wiki, which makes it so easy to install.
After you get the dependencies and the Wikidot source, you need to prepare a database and populate it. Normally this means two make commands (one for postgres user and second for your regular user). The default configuration options are to provide you a simple single-wiki engine, that just works. This means, that however you connect to Wikidot (with any IP or DNS name), you get the single wiki that you created. Wikidot needs a full namespace of URLs (starting from /), so you can't simply put it along with other web applications. This is why by default we use port 8080 for serving Wikidot. Also as we rely on very custom Lighttpd configuration, we supply a config file for it (that is partially generated when doing make). But don't worry, we also have a script that let's you control it. ./wikidotctl start starts Wikidot's Lighttpd, ./wikidotctl stop stops it. Pretty straight-forward, isn't it?
But Wikidot software is also a full-featured wiki-farm solution. But you need a different database dump (that adds more wikis, like template wiki for each newly created wiki) and a different configuration. First of all, you need a full domain name namespace (for example *.mywikidot.mycompany.com). What's before .mywikidot.mycompany.com in the domain name is the name of wiki, so if you connect to abc.mywikidot.mycompany.com displayed is abc wiki. Also as this gets a bit complicated to deal with when having custom port, you need to run the Lighttpd on port 80 (the standard WWW port). This means, if you want to host a full wiki farm, you need to have a separate IP address just for Wikidot (any other web server can be run on a non-standard port only), and a root access to start Lighttpd (only root can bind to ports smaller than 1024).
Actually you need quite a lot knowledge to understand what the wiki-farm-mode Wikidot does and to configure it, but once you get it, it's quite easy. Anyway, all I want to say, is that we want to ease the simplest (and most common) installation of Wikidot. If you want to have a wiki, but want to host it yourself rather that on Wikidot.com, this is done just for you, just get the dependencies, Wikidot sources, prepare database, make and you're done. No need for painful configuration :).
If you decided to run your own wiki farm (in your company for example) start from getting single-wiki Wikidot running and then use older docs to figure out how to get it running as a wiki-farm. In case of problems, just ask on IRC channel. TIP: you need to set wiki_farm = true in [main] section in conf/wikidot.ini file.
I hope more wiki enthusiasts will get simple Wikidot running at their work and school rather than choosing other wiki engine. They used to do that, because they were simpler to install. Now this changes.
There is one more important note to make. We're going to polish the software, to make it run smoothly, so download (git clone) and test it as much as you can and please report bugs. You don't even have to be a registered Wikidot user to do that. Once we get all the quirks fixed, we want to release Debian/Ubuntu packages, that will enable you to just state aptitude install wikidot to get the Wikidot up and running in minutes without you touching the keyboard after that (well maybe to configure the Admin password). So if you can't wait for this to happen, please help us and test!