diff --git a/doc/setup.rst b/doc/setup.rst
index 7a0dc4beff..ab1c7be447 100644
--- a/doc/setup.rst
+++ b/doc/setup.rst
@@ -310,6 +310,12 @@ Linux/Unix system you can use the following commands:
     mkdir config                        # create directory for saving
     chmod o+rw config                   # give it world writable permissions
 
+.. note::
+
+    Following documentation covers default behavior of phpMyAdmin. Some
+    distributions have changed this, please check following sections for
+    information on this topic.
+
 And to edit an existing configuration, copy it over first:
 
 .. code-block:: sh
@@ -318,11 +324,6 @@ And to edit an existing configuration, copy it over first:
     cp config.inc.php config/           # copy current configuration for editing
     chmod o+w config/config.inc.php     # give it world writable permissions
 
-.. note::
-
-    Debian and Ubuntu have simplified this setup and all you need to do is to
-    execute :program:`/usr/sbin/pma-configure`.
-
 On other platforms, simply create the folder and ensure that your web
 server has read and write access to it. :ref:`faq1_26` can help with
 this.
@@ -349,10 +350,6 @@ measure:
     chmod o-rw config.inc.php          # remove world read and write permissions
     rm -rf config                      # remove not needed directory
 
-.. note::
-
-    Debian and Ubuntu have simplified this setup and all you need to do is to
-    execute :program:`/usr/sbin/pma-secure`.
 
 Now the file is ready to be used. You can choose to review or edit the
 file with your favorite editor, if you prefer to set some advanced
@@ -370,6 +367,32 @@ options which the setup script does not provide.
    a login dialog if using :term:`HTTP` or
    cookie authentication mode.
 
+Setup script on Debian, Ubuntu and derivatives
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Debian and Ubuntu have changed way how setup is enabled and disabled, in a way
+that single command has to be executed for either of these.
+
+To allow editing configuration invoke:
+
+.. code-block:: sh
+
+   /usr/sbin/pma-configure
+
+To block editing configuration invoke:
+
+.. code-block:: sh
+    
+    /usr/sbin/pma-secure
+
+Setup script on openSUSE
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Some openSUSE releases do not include setup script in the package. In case you
+want to generate configuration on these you can either download original
+package from <https://www.phpmyadmin.net/> or use setup script on our demo
+server: <https://demo.phpmyadmin.net/master/setup/>.
+
 
 .. _verify: