This describes how to install a docker image of Kolab.
Please note: this is not meant to be for production use. The main purpose is to provide an easy way for demonstration of features and for product validation.
This installation has not been tested a lot, and could still use some fine tuning. This is just a demonstration of what could be done with Docker for Kolab.
Preparing for Docker
I am using a Jiffybox provided by DomainFactory for downloading a Docker container for Kolab 3.1 running on CentOS 6.
I have installed Ubuntu 12.04 LTS on a Jiffybox.
I am therefore following Docker Installation instructions for Ubuntu for the installation instructions:
Install a kernel that is required by Docker:
sudo apt-get update sudo apt-get install linux-image-generic-lts-raring linux-headers-generic-lts-raring |
After that, in the admin website of JiffyBox, select the custom kernel Bootmanager 64 Bit (pvgrub64); see also the german JiffyBox FAQ. Then restart your JiffyBox.
After the restart, uname -a should show something like:
Linux j89610.servers.jiffybox.net 3.8.0-37-generic #53~precise1-Ubuntu SMP Wed Feb 19 21:37:54 UTC 2014 x86_64 x86_64 x86_64 GNU/Linux |
Now install docker:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 36A1D7869245C8950F966E92D8576A8BA88D21E9 sudo sh -c "echo deb http://get.docker.io/ubuntu docker main > /etc/apt/sources.list.d/docker.list" sudo apt-get update sudo apt-get install lxc-docker |
Install container
The image for the container is available here:
https://index.docker.io/u/tpokorra/kolab31_centos6/
If you want to know how this image was created, read my other blog post http://www.pokorra.de/2014/03/building-a-docker-container-for-kolab-on-jiffybox.
To install this image, you need to type in this command:
docker pull tpokorra/kolab31_centos6 |
You can create a container from this image and run it:
MYAPP=$(sudo docker run --name centos6_kolab31 -p 443:443 -h kolab31.test.example.org -d -t -i tpokorra/kolab31_centos6) |
(-P should work instead of -p 443:443 and use the ports defined by EXPOSE in Dockerfile, but that does not work for me at the moment…)
You can see all your containers:
docker ps -a |
You now have to attach to the container, and inside the container start the services:
docker attach $MYAPP /root/start.sh |
Somehow it should work to start the services automatically at startup, but I did not get it to work with CMD or ENTRYPOINT.
To stop the container, type exit on the container’s console, or run from outside:
docker stop $MYAPP |
To delete the container:
docker rm $MYAPP |
You can reach the Kolab Webadmin on this URL:
https://localhost/kolab-webadmin. Login with user: cn=Directory Manager, password: test
The Webmail interface is available here:
https://localhost/roundcubemail.