diff --git a/doc/02-Installation.md b/doc/02-Installation.md
index 79c3cf850..ea2bd2720 100644
--- a/doc/02-Installation.md
+++ b/doc/02-Installation.md
@@ -13,25 +13,12 @@ thoroughly.
* PHP >= 5.3.0 w/ gettext, intl, mbstring and OpenSSL support
* Default time zone configured for PHP in the php.ini file
* LDAP PHP library when using Active Directory or LDAP for authentication
-* Icinga 1.x w/ IDO; Icinga 2.x w/ IDO feature enabled
+* Icinga 2.x w/ IDO feature enabled or Icinga 1.x w/ IDO
* The IDO table prefix must be icinga_ which is the default
* MySQL or PostgreSQL PHP libraries
* cURL PHP library when using the Icinga 2 API for transmitting external commands
-### PageSpeed Module Incompatibility
-It seems that Web 2 is not compatible with the PageSpeed module. Please disable the PageSpeed module using one of the
-following methods.
-
-**Apache**:
-```
-ModPagespeedDisallow "*/icingaweb2/*"
-```
-
-**Nginx**:
-```
-pagespeed Disallow "*/icingaweb2/*";
-```
## Installing Icinga Web 2 from Package
@@ -61,12 +48,12 @@ Below is a list with **examples** for various distributions.
**Debian Jessie**:
```
wget -O - http://packages.icinga.com/icinga.key | apt-key add -
-echo 'deb http://packages.icinga.com/debian icinga-jessie main' >/etc/apt/sources.list.d/icinga.list
+echo 'deb http://packages.icinga.com/debian icinga-stretch main' >/etc/apt/sources.list.d/icinga.list
apt-get update
```
> INFO
>
-> For other Debian versions just replace jessie with your distribution's code name.
+> For other Debian versions just replace `stretch` with your distribution's code name.
**Ubuntu Xenial**:
```
@@ -78,18 +65,14 @@ apt-get update
>
> For other Ubuntu versions just replace xenial with your distribution's code name.
-**RHEL and CentOS**:
+**RHEL and CentOS 7**:
```
-rpm --import http://packages.icinga.com/icinga.key
-curl -o /etc/yum.repos.d/ICINGA-release.repo http://packages.icinga.com/epel/ICINGA-release.repo
-yum makecache
+yum install https://packages.icinga.com/epel/7/release/noarch/icinga-rpm-release-7-2.el7.centos.noarch.rpm
```
-**Fedora**:
+**Fedora 25**:
```
-rpm --import http://packages.icinga.com/icinga.key
-curl -o /etc/yum.repos.d/ICINGA-release.repo http://packages.icinga.com/fedora/ICINGA-release.repo
-yum makecache
+dnf install https://packages.icinga.com/fedora/25/release/noarch/icinga-rpm-release-25-1.fc25.noarch.rpm
```
**SLES 11**:
@@ -120,10 +103,16 @@ apk update
> Latest version of Icinga Web 2 is in the edge repository, which is the -dev branch.
#### RHEL/CentOS Notes
+The packages for RHEL/CentOS depend on other packages which are distributed
+as part of the [EPEL repository](https://fedoraproject.org/wiki/EPEL).
-The packages for RHEL/CentOS depend on other packages which are distributed as part of the
-[EPEL repository](http://fedoraproject.org/wiki/EPEL). Please make sure to enable this repository by following
-[these instructions](http://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F).
+CentOS 7/6:
+```
+yum install epel-release
+```
+
+If you are using RHEL you need enable the `optional` repository and then install
+the [EPEL rpm package](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F).
> Please note that installing Icinga Web 2 on **RHEL/CentOS 5** is not supported due to EOL versions of PHP and PostgreSQL.
@@ -484,6 +473,24 @@ password = "api"
Finally visit Icinga Web 2 in your browser to login as `icingaadmin` user: `/icingaweb2`.
+## Troubleshooting
+
+### PageSpeed Module Incompatibility
+
+It seems that Web 2 is not compatible with the PageSpeed module. Please disable the PageSpeed module using one of the
+following methods.
+
+**Apache**:
+```
+ModPagespeedDisallow "*/icingaweb2/*"
+```
+
+**Nginx**:
+```
+pagespeed Disallow "*/icingaweb2/*";
+```
+
+
## Automating the Installation of Icinga Web 2
If you are automating the installation of Icinga Web 2, you may want to skip the wizard and do things yourself.