diff --git a/doc/installation.md b/doc/installation.md
index eb67d1ec2..2799cd20e 100644
--- a/doc/installation.md
+++ b/doc/installation.md
@@ -3,6 +3,10 @@
 The preferred way of installing Icinga Web 2 is to use the official package repositories depending on which operating
 system and distribution you are running. But it is also possible to install Icinga Web 2 directly from source.
 
+In case you are upgrading from an older version of Icinga Web 2
+please make sure to read the [upgrading](upgrading) section
+throroughly.
+
 ## <a id="installing-requirements"></a> Installing Requirements
 
 * A web server, e.g. Apache or nginx
@@ -249,6 +253,8 @@ In case you do not remember the token you can show it using the `icingacli`:
 Finally visit Icinga Web 2 in your browser to access the setup wizard and complete the installation:
 `/icingaweb2/setup`.
 
+# <a id="upgrading"></a> Upgrading Icinga Web 2
+
 ## <a id="upgrading-to-beta2"></a> Upgrading to Icinga Web 2 Beta 2
 
 Icinga Web 2 Beta 2 introduces access control based on roles for secured actions. If you've already set up Icinga Web 2,