diff --git a/docs/source/configuration.rst b/docs/source/configuration.rst
index 824f10fbc4..33319f404e 100644
--- a/docs/source/configuration.rst
+++ b/docs/source/configuration.rst
@@ -4,6 +4,12 @@ Kiwi TCMS configuration settings
 All sensible settings are defined in ``tcms/settings/common.py``. You will have
 to update some of them for your particular production environment.
 
+.. note::
+
+    After adjusting settings for your environment you have to configure
+    Kiwi TCMS via its web interface! As a minimum you have to
+    :ref:`configure-kiwi-base-url`!
+
 .. literalinclude:: ../../tcms/settings/common.py
    :language: python
 
diff --git a/docs/source/guide/admin.rst b/docs/source/guide/admin.rst
index 238c2ed174..18d4935cf2 100644
--- a/docs/source/guide/admin.rst
+++ b/docs/source/guide/admin.rst
@@ -13,6 +13,8 @@ The ADMIN tab allows administrators to manage:
 
 |The Administration screen|
 
+.. _configure-kiwi-base-url:
+
 Configure Kiwi's base URL
 -------------------------