This page describes the installation of the [http://cryptobox.org CryptoBox server] from the sources. The source package should be installable in many modern Linux distributions. Unfortunately you have to fulfil some dependencies manually, which might take a while.

We have described two ways of installation. One for openSUSE 10.2 and another for Debian/etch (4.0). If you installed a CryptoBox server in any other Linux distribution, pleas leave a comment about your experience or extend this site.

TableOfContents

CryptoBox server in openSUSE 10.2

Preparation

• Install the packages python-devel und gcc via yast. They are in the main openSUSE repository.

  • These two packages are just needed to install the CryptoBox dependent software and can be removed afterwards.

• In the same way you have to install util-linux-crypto.

  • This package contains a program called cryptsetup, which mainly does the encryption work.

  • It is important, that cryptsetup includes support for [http://luks.endorphin.org/ LUKS]. This is the case in openSUSE 10.2.

• Add a new user to your system e.g.: cryptobox. With the rights of this user the CryptoBox will later run.

  • Do all the following steps as this user. Sometimes you need root rights. You can use the su and giving the root passphrase command for that.

CherryPy 2.2

• Download the latest [http://download.cherrypy.org/cherrypy/2.2.1/ CherryPy version from the 2.2 branch] (here: 2.2.1) to /tmp and unpack and install it with the following commands:

  cd /tmp
  tar zxf CherryPy-2.2.1.tar.gz
  cd CherryPy-2.2.1
  su -c "python setup.py install"

Python Clearsilver

• Download the latest [http://www.clearsilver.net/downloads/clearsilver-0.10.5.tar.gz ClearSilver Source Release] (here: 0.10.5) to /tmp and install it with the following commands:

  cd /tmp
  tar zxf clearsilver-0.10.5.tar.gz
  cd clearsilver-0.10.5
  ./configure --prefix=/usr --diable-java --diable-perl --disable-csharp --disable-ruby --disable-apache --enable-gettext --with-python=/usr/bin/python
  make
  su -c "make install"

super

• Download the [ftp://ftp.ucolick.org/pub/users/will/ latest version of "super"] (here 3.27.1) and install it. This allows to run the CryptoBox with a non-root uid.

  cd /tmp
  tar zxf super_3.27.1.orig.tar.gz
  ./configure
  make
  su -c "make install"

• This installs super to /usr/local/bin/super. You have to change the corresponding path in the cryptobox.conf file.

• The correct configfile in this case is /usr/local/etc/super.tab - not /etc/super.tab. This is important as you later have to add a line to this configfile.

Python ConfigObj

• Install python-configobj via yast if you have the packamn repository in your rpm database.

• Otherwise download an actual [http://packman.links2linux.de/package/python-configobj python-configobj.rpm] file from the packman openSUSE repository and install it with:

  su -c "rpm -i python-configobj-4.4.0-0.pm.1.i586.rpm"

Python M2Crypto

• Install python-m2crypto via yast if you have the openSUSE development repository in your rpm database.

• Otherwise download an actual [http://ftp.opensuse.org/pub/opensuse/repositories/devel:/languages:/python/openSUSE_10.2/i586/python-m2crypto-0.17-1.1.i586.rpm python-m2crypto.rpm] (here 0.17) and install:

  su -c "rpm -i python-m2crypto-0.17-1.1.i586.rpm"

CryptoBox server

• Puh, after that you at least learned the magic spell (./configure && make && make install) to install source packages and the Python way of installing software (python setup.py install).

• Now you're ready to get the latest [http://codecoop.org/frs/download.php/120/cryptobox-server_0.3.4.4-1.tar.gz CryptoBox server sources] (here 0.3.4.4-1) from codecoop and unpack it:

  cd /tmp
  tar zxf cryptobox-server_0.3.4.4-1.tar.gz
  cd cryptobox-server_0.3.4.4-1
  su -c "python setup.py install"

• Copy the conf-examples/super.tab-example to /usr/local/etc/super.tab (depends on your super installation) and modify it to your needs.

• Now you should be able to start the CryptoBox server by running:

  ./bin/run_webserver.sh

  • Do that as user cryptobox not as root.

  • The command returns some infromation about the server. One line should look like this "INFO Serving HTTP on http://localhost:8080/". This means you did it.

  • If there are any error messages read them carefully. There's most likely some of the dependent software missing. Fix it and start the run_webserver script again.

    • Did you install every tool as described? Did you configure super correctly?

  • Now, visit the printed url (here: http://localhost:8080) with your webbrowser. You'll see the CryptoBox webinterface. Congratulations!

    • The webinterface will complain about some things.

Finalization

• To have a complete working CryptoBox server you need some additional software which is probably already installed on your server otherwise install them.

  • samba
  • stunnel4
  • e2fsprogs
  • dosfstools

• If you need further help take a look into the [http://devel.cryptobox.org/wiki/CryptoBoxUser/en CryptoBox user documentation].

CryptoBox server in Debian/etch

Preparation

• If you for whatever reasons don't want to use the [http://codecoop.org/frs/?group_id=60&release_id=69 CryptoBox server Debian package] (our recommendation), you need some preparations to use the source package or the code from the svn.

  apt-get install python python-central python-clearsilver python-cherrypy python-configobj python-m2crypto super cryptsetup

CryptoBox server

• Get the sources, unpack and install them the Python way

  cd /tmp
  wget http://codecoop.org/frs/download.php/120/cryptobox-server_0.3.4.4-1.tar.gz
  tar zxf cryptobox-server_0.3.4.4-1.tar.gz
  cd cryptobox-server_0.3.4.4-1
  su -c "python setup.py install"

• Edit /etc/super.tab like described in conf-examples/super.tab-example.

• Start the CryptoBox with:

  ./bin/run_webserver.sh

• Read the messages, if there's no error take a look at "http://localhost:8080". You're up and ready.

Finalization

• Finally install some more useful software.

  apt-get install samba stunnel4 e2fsprogs dosfstools

• If you need further help take a look into the [http://devel.cryptobox.org/wiki/CryptoBoxUser/en CryptoBox user documentation].