This page describes the installation of the 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.

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 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 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 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 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 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 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 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 CryptoBox user documentation.

CryptoBox server in Debian/etch

Preparation

• If you for whatever reasons don't want to use the 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 CryptoBox user documentation.