diff --git a/source/getting-started/troubleshooting.markdown b/source/getting-started/troubleshooting.markdown
index eda34e41dfc..f5d2b7c6d7c 100644
--- a/source/getting-started/troubleshooting.markdown
+++ b/source/getting-started/troubleshooting.markdown
@@ -69,11 +69,4 @@ Android Chrome
 chrome -> settings -> site settings -> storage -> search for your URL for home assistant-> "clear & reset"
 
 
-#### {% linkable_title Run the development version %}
-If you want to stay on top of the development of Home Assistant then you can upgrade to the `dev` branch. This can result in an unstable system, loss of data, etc. etc.
-
-```bash
-$ pip3 install --upgrade git+git://github.com/balloob/home-assistant.git@dev
-```
-
 ### [« Back to Getting Started](/getting-started/)
diff --git a/source/getting-started/updating.markdown b/source/getting-started/updating.markdown
index 649b6fe3539..b726cf6bbb7 100644
--- a/source/getting-started/updating.markdown
+++ b/source/getting-started/updating.markdown
@@ -18,3 +18,18 @@ $ pip3 install --upgrade homeassistant
 
 After updating, restart Home Assistant for the changes to take effect. This means that you have to restart `hass` itself or the [autostarting](/getting-started/autostart/) daemon if you use any.
 
+
+<p class='note note'>
+  The upgrade needs to be run as the same user as the installation was done to avoid permission errors.
+</p>
+
+#### {% linkable_title Run the development version %}
+If you want to stay on top of the development of Home Assistant then you can upgrade to the `dev` branch. 
+
+<p class='note warning'>
+  This can result in an unstable system, loss of data, etc. etc.
+</p>
+
+```bash
+$ pip3 install --upgrade git+git://github.com/home-assistant/home-assistant.git@dev
+```