diff --git a/doc/upgrade.rst b/doc/upgrade.rst
index c66a30455..3bdad2369 100644
--- a/doc/upgrade.rst
+++ b/doc/upgrade.rst
@@ -84,6 +84,21 @@ documentation.
 Specific instructions
 *********************
 
+1.8.3
+=====
+
+Edit the :file:`settings.py` file and replace the following line:
+
+.. sourcecode:: python
+
+   BASE_DIR = os.path.dirname(os.path.dirname(__file__))
+
+by:
+
+.. sourcecode:: python
+
+   BASE_DIR = os.path.realpath(os.path.dirname(os.path.dirname(__file__)))
+
 1.8.0
 =====
 
diff --git a/modoboa/core/commands/templates/settings.py.tpl b/modoboa/core/commands/templates/settings.py.tpl
index 2b9369149..a1ed35115 100644
--- a/modoboa/core/commands/templates/settings.py.tpl
+++ b/modoboa/core/commands/templates/settings.py.tpl
@@ -16,7 +16,7 @@ from logging.handlers import SysLogHandler
 from modoboa.core.dev_settings import *
 {% endif %}
 
-BASE_DIR = os.path.dirname(os.path.dirname(__file__))
+BASE_DIR = os.path.realpath(os.path.dirname(os.path.dirname(__file__)))
 
 
 # Quick-start development settings - unsuitable for production