Installing MindTouch package on Debian Etch / Ubuntu 7.10

The purpose of this page is to install MindTouch on Debian flavoured systems using APT (Advanced Packaging Tool).

Please report any issues regarding the installation to this forum. Your feedback will be greatly appreciated.

• Add the MindTouch repository

As "root", edit the "/etc/apt/sources.list" file to add the following line : 

On DEBIAN ETCH

deb http://repo.mindtouch.com Debian_Etch/

On UBUNTU 7.10

deb http://repo.mindtouch.com xUbuntu_7.10/

 then update your package indexes

$ apt-get update

• Install recommended packages [optional]

These packages are not required but recommended for the optimal MindTouch experience !

$ sudo apt-get install wv gs

Note: some of these packages will not be available on all distros, you may have to check the projects websites.

• Install Prince XML [optional]

Prince XML is used by MindTouch for saving your pages as PDF. Follow these instructions to install Prince XML on your system.

• Install MindTouch

 Install MindTouch using the following command :

$ sudo apt-get install dekiwiki

answer "yes" to all authentication/verification questions.

Note: installation of some dependencies might need interaction (MySQL for example may ask you to set an administrator password).

• Configure and enable Apache virtualhost

You now may want to check the MindTouch configuration file for Apache "/etc/apache2/sites-available/dekiwiki", adapt it to your needs and then enable it :

$ sudo a2ensite dekiwiki
$ sudo /etc/init.d/apache2 reload

MindTouch is now installed and you should be able to connect to "http://your_server/config/index.php" to complete the configuration.

• Appendix : Get the sources package

Append the following line to your "/etc/apt/sources.list" file : 

deb-src http://repo.mindtouch.com Debian_Etch/   ( or xUbuntu_7.10/ )

Install the sources :

$ apt-get source dekiwiki

• Appendix : Upgrade MindTouch

If you let the MindTouch repository in your "/etc/apt/sources.list" file, APT might prompt you whenever a new release is available and ask you for an upgrade.

Package upgrades are supported from 1.9.0 (Itasca) or later releases. To upgrade manually to the latest release, type :

$ sudo apt-get install dekiwiki

Once the upgrade complete, you will have to :

- Check the new "/etc/apache2/sites-available/dekiwiki" configuration and enable it once validated :

$ sudo a2ensite dekiwiki
$ sudo /etc/init.d/apache2 reload

- Restart the MindTouch service :

$ sudo /etc/init.d/dekiwiki restart

- Flush your browser cache (recommended).