diff --git a/docs.it4i/index.md b/docs.it4i/index.md
index f962a18ab4797d7ab859cba51f9d73f60961ec2c..2de8811972d2f469d274f38095f696d01e336fd0 100644
--- a/docs.it4i/index.md
+++ b/docs.it4i/index.md
@@ -1,5 +1,8 @@
 # Documentation
 
+!!! Warning
+    There's a planned Salomon upgrade. Make sure to read the [details][upgrade].
+
 Welcome to the IT4Innovations documentation pages. The IT4Innovations national supercomputing center operates the supercomputers [Salomon][1] and [Anselm][2]. The supercomputers are [available][3] to the academic community within the Czech Republic and Europe, and the industrial community worldwide. The purpose of these pages is to provide comprehensive documentation of the hardware, software and usage of the computers.
 
 ## How to Read the Documentation
@@ -70,6 +73,7 @@ By doing so, you can save other readers from frustration and help us improve.
 [2]: anselm/introduction.md
 [3]: general/applying-for-resources.md
 [4]: salomon/resources-allocation-policy.md#normalized-core-hours-nch
+[upgrade]: salomon-upgrade.md
 
 [a]: mailto:support@it4i.cz
 [b]: http://support.it4i.cz/rt
diff --git a/docs.it4i/salomon-upgrade.md b/docs.it4i/salomon-upgrade.md
new file mode 100644
index 0000000000000000000000000000000000000000..5c91e8d7765f1beb3a899220140ad4f187c15214
--- /dev/null
+++ b/docs.it4i/salomon-upgrade.md
@@ -0,0 +1,18 @@
+# Upgrade of Salomon Cluster
+
+There's a planned upgrade of Salomon on 2018-12-xx til 2018-12-xx.
+
+!!! Warning
+    This upgrade will introduce a lot of changes with respect to production and user experience.
+
+Salomon operating system will be upgraded to the latest CentOS 7.5. We will be able to support latest software versions and keep the cluster security with upstream releases.
+
+ Major changes are:
+
+* kernel will be upgraded to 3.10.0 (now 2.6.32)
+* glibc will be upgraded to 2.17 (now 2.12)
+
+
+## FAQ
+
+## Discontinued Modules
diff --git a/mkdocs.yml b/mkdocs.yml
index 46187bd47fddadef7720aa2e95cc787f31652a38..a7b2b08203f480d12081a314946984b9fea49fee 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -54,6 +54,7 @@ nav:
       - VPN Access: general/accessing-the-clusters/vpn-access.md
     - PRACE User Support: prace.md
     - API Documentation: apiv1.md
+    - Salomon Upgrade: salomon-upgrade.md
   - Salomon:
     - Introduction: salomon/introduction.md
     - Hardware Overview: salomon/hardware-overview.md