From 1d2eb9f4127cc12dc8a338ec2ce0b7a2680ce15f Mon Sep 17 00:00:00 2001
From: DubhAd <DubhAd@users.noreply.github.com>
Date: Sun, 31 Mar 2019 11:41:21 +0100
Subject: [PATCH] Adding upgrade details (#8643)

* Adding upgrade details

Adding details here on how to upgrade and run specific versions, rather than leaving them as incomplete generic steps in the Updating page

* :pencil2: Tweaks
---
 .../_docs/installation/raspberry-pi.markdown  | 38 ++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

diff --git a/source/_docs/installation/raspberry-pi.markdown b/source/_docs/installation/raspberry-pi.markdown
index 136c1ae2bb5..2e412cf0756 100644
--- a/source/_docs/installation/raspberry-pi.markdown
+++ b/source/_docs/installation/raspberry-pi.markdown
@@ -106,7 +106,43 @@ $ source /srv/homeassistant/bin/activate
 $ pip3 install --upgrade homeassistant
 ```
 
-Once the last command executes restart the Home Assistant service to apply the latest updates.  Please keep in mind that some updates may take longer to boot up than others.  If Home Assistant fails to start make sure you check the **Breaking Changes** from the [Release Notes](https://github.com/home-assistant/home-assistant/releases).
+Once the last command executes, restart the Home Assistant service to apply the latest updates. Please keep in mind that some updates may take longer to start up than others. If Home Assistant fails to start, make sure you check the **Breaking Changes** from the [Release Notes](https://github.com/home-assistant/home-assistant/releases).
+
+### {% linkable_title Run a specific version %}
+
+In the event that a Home Assistant version doesn't play well with your hardware setup, you can downgrade to a previous release. For example:
+
+```bash
+$ sudo -u homeassistant -H -s
+$ source /srv/homeassistant/bin/activate
+$ pip3 install homeassistant==0.XX.X
+```
+
+### {% linkable_title Run the beta version %}
+
+If you would like to test next release before anyone else, you can install the beta version released every two weeks, for example:
+
+```bash
+$ sudo -u homeassistant -H -s
+$ source /srv/homeassistant/bin/activate
+$ pip3 install --pre --upgrade homeassistant
+```
+
+### {% linkable_title Run the development version %}
+
+If you want to stay on the bleeding-edge Home Assistant development branch, you can upgrade to `dev`.
+
+<p class='note warning'>
+  The "dev" branch is likely to be unstable. Potential consequences include loss of data and instance corruption.
+</p>
+
+For example:
+
+```bash
+$ sudo -u homeassistant -H -s
+$ source /srv/homeassistant/bin/activate
+$ pip3 install --upgrade git+git://github.com/home-assistant/home-assistant.git@dev
+```
 
 ### {% linkable_title Activating the virtual environment %}