diff --git a/doc/02-Installation.md b/doc/02-Installation.md
index 8d3200b4..344fee72 100644
--- a/doc/02-Installation.md
+++ b/doc/02-Installation.md
@@ -6,6 +6,9 @@ all supported platforms from our official release repository.
 Please follow the steps listed for your target operating system,
 which guide you through setting up the repository and installing Icinga DB Web.
 
+To upgrade an existing Icinga DB Web installation to a newer version,
+see the [Upgrading](05-Upgrading.md) documentation for the necessary steps.
+
 ![Icinga DB Web](res/icingadb-web.png)
 
 Before installing Icinga DB Web, make sure you have installed the
diff --git a/doc/05-Upgrading.md b/doc/05-Upgrading.md
new file mode 100644
index 00000000..7bb3efdd
--- /dev/null
+++ b/doc/05-Upgrading.md
@@ -0,0 +1,16 @@
+# Upgrading Icinga DB Web
+
+Specific version upgrades are described below. Please note that version upgrades are incremental.
+If you are upgrading across multiple versions, make sure to follow the steps for each of them.
+
+## Upgrading to Icinga DB Web v1.0
+
+**Requirements**
+
+* You need at least Icinga DB version 1.0.0 to run Icinga DB Web v1.0.0.
+
+**Configuration Changes**
+
+* The restrictions `icingadb/blacklist/routes` and `icingadb/blacklist/variables` have been renamed to
+  `icingadb/denylist/routes` and `icingadb/denylist/variables` respectively. If you use this restriction,
+  make sure to adjust `/etc/icingaweb2/roles.ini` accordingly.