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.3 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 [http://luks.endorphin.org/ LUKS]. This is the case in openSUSE 10.2.

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
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
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
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

Download a [http://packman.links2linux.de/package/python-configobj python-configobj.rpm] file from the packman openSUSE repository and install it with:
```
rpm -i python-configobj-4.4.0-0.pm.1.i586.rpm
```

CryptoBox server

Puh after that you at least know 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
python setup.py install
```
TODO

Finalization

To have a complete working CryptoBox server you need some additional software which is probably already installed on your server.
- samba
- stunnel4
- e2fsprogs
- dosfstools

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 e2fsprogs dosfstools
```

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
python setup.py install

Finalization

Finally install some more useful software.
```
apt-get install samba, apache2, stunnel4
```