diff --git a/README.md b/README.md
index b44d1a2..42b9197 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,4 @@
-# mrw.sh
+Documentation of https://mrw.sh
+===============================
 
-Documentation regarding MRW's development environment on https://mrw.sh.
\ No newline at end of file
+Documentation regarding MRW's development environment on https://mrw.sh.
diff --git a/installation.md b/installation.md
new file mode 100644
index 0000000..acf9da2
--- /dev/null
+++ b/installation.md
@@ -0,0 +1,111 @@
+Install Software
+================
+
+There are prebuilt software packages in the repositories, look in
+https://repository.mrw.sh for your operating system.
+
+Note: PublicKey has changed on Novmber 1st 2015, please import the new
+key.
+
+Linux
+-----
+
+### Ubuntu and Debian
+
+Simply use the package repository, then you can install all software
+using your package manager (`apt`):
+
+        sudo apt-get install -y wget software-properties-common apt-transport-https
+        sudo apt-add-repository https://dev.marc.waeckerlin.org/repository
+        wget -O- https://dev.marc.waeckerlin.org/repository/PublicKey \
+            | sudo apt-key add -
+        sudo apt-get update -y
+
+Then you can install the project you wish, e.g. `webtester`:
+
+        sudo apt-get install webtester -y
+
+### OpenSUSE
+
+You can use your packagemanager (`zypper` or _YaST_). First install the repostitory:
+
+        zypper ar https://dev.marc.waeckerlin.org/repository/opensuse/marc-waeckerlin.repo
+
+Then install packages from the repository, e.g. `webtester`:
+
+        zypper install webtester
+
+In case of trouble: Check if your version of OpenSUSE is supported,
+use `lsb_release -rs` to get the version of your OpenSUSE:
+https://drepository.mrw.sh/opensuse
+
+### Fedora
+
+You can use your packagemanager (`dnf`). First install the repository:
+
+        dnf install 'dnf-command(config-manager)'
+        dnf config-manager --add-repo https://dev.marc.waeckerlin.org/repository/fedora/marc-waeckerlin.repo
+
+Then install packages from the repository, e.g. `webtester`:
+
+        dnf install webtester
+
+In case of trouble: Check if your version of Fedora is supported, use `lsb_release -rs` to get the version of your Fedora: https://repository.mrw.sh/fedora
+
+### CentOS
+
+You can use your packagemanager (`yum`). First install the repository:
+
+        yum install wget
+        wget -O/etc/yum.repos.d/marc-waeckerlin.repo https://dev.marc.waeckerlin.org/repository/centos/marc-waeckerlin.repo
+
+Then install packages from the repository, e.g. `webtester`:
+
+        yum install webtester
+
+In case of trouble: Check if your version of CentOS is supported, use lsb_release -rs to get the version of your CentOS: https://repository.mrw.sh/centos
+
+### Mageia
+
+To be defined, get packages from: https://repository.mrw.sh/mageia
+
+Currently build fails due to corrupt mirrors:
+
+        Installation failed, bad rpms:
+        http://mirrors.ustc.edu.cn/mageia/distrib/5/x86_64/media/core/updates/glibc-2.20-23.mga5.x86_64.rpm
+
+### Other Linux Distributions
+
+Either use the nearest possible distribution, or use alien to convert from another distribution to your preferred package format, or compile the project yourself (see below).
+
+Windows
+-------
+
+Download from https://dev.marc.waeckerlin.org/repository/windows
+
+MacOSX
+------
+
+You need e.g. Mac Ports to compile. Install the following dependencies:
+
+        sudo port install subversion svn2cl doxygen graphviz cppunit libtool boost log4cxx qt5-mac
+
+Fix libtool-bug:
+
+        sudo ln -s /opt/local/bin/glibtoolize /opt/local/bin/libtoolize
+
+Compile from Source
+-------------------
+
+For all unsupported operating systems, including MacOSX.
+
+To compile, please download the tar-sources from: https://repository.mrw.sh/sources
+
+Then untar the package and use the common commands, e.g. for version `1.0.2` of a project named project, that means:
+
+        tar xzf project-1.0.2.tar.gz
+        cd project-1.0.2
+        ./bootstrap.sh
+        ./configure
+        make
+        sudo make install