## page was renamed from CryptoBox server in opensuse
## page was renamed from CryptoBox Server in OpenSue 10.2
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 --disable-java --disable-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]].