diff --git a/apps/homeassistant-1/metadata/description.md b/apps/homeassistant-1/metadata/description.md
index 242fee68..70f9027b 100644
--- a/apps/homeassistant-1/metadata/description.md
+++ b/apps/homeassistant-1/metadata/description.md
@@ -8,14 +8,15 @@ Check out [home-assistant.io](https://home-assistant.io) for a [demo](https://ho
 
 February 2024
 
-This version of Home Assistant can be exposed. To migrate from the previous, non exposable app, follow these steps:
+This version of Home Assistant can be exposed. To migrate from the non-exposable app, follow these steps:
 
-- stop the previous app
+- stop the installed app
 - rename `runtipi/app-data/homeassistant` to `runtipi/app-data/__homeassistant`
-- remove the (previous) app
-- install the (the current) app
-- remove `runtipi/app-data/homeassistant`
-- rename `runtipi/app-data/__homeassistant` to `runtipi/app-data/homeassistant`
+- uninstall the app
+- install Home Assiatant from the App Store
+- do NOT start the app
+- remove `runtipi/app-data/homeassistant-1`
+- rename `runtipi/app-data/__homeassistant` to `runtipi/app-data/homeassistant-1`
 - add the following section to `runtipi/app-data/homeassistant/data/config/configuration.yaml`
   ```
   http:
diff --git a/apps/homeassistant/config.json b/apps/homeassistant/config.json
index 84b5a14f..0364386b 100644
--- a/apps/homeassistant/config.json
+++ b/apps/homeassistant/config.json
@@ -4,7 +4,7 @@
   "available": true,
   "deprecated": true,
   "port": 8123,
-  "tipi_version": 2,
+  "tipi_version": 3,
   "version": "stable",
   "id": "homeassistant",
   "categories": [
diff --git a/apps/homeassistant/metadata/description.md b/apps/homeassistant/metadata/description.md
index b7b2a420..6eb8bd35 100644
--- a/apps/homeassistant/metadata/description.md
+++ b/apps/homeassistant/metadata/description.md
@@ -4,4 +4,30 @@
 Open source home automation that puts local control and privacy first. Powered by a worldwide community of tinkerers and DIY enthusiasts. Perfect to run on a Raspberry Pi or a local server.
 Check out [home-assistant.io](https://home-assistant.io) for a [demo](https://home-assistant.io/demo/), installation [instructions](https://home-assistant.io/getting-started/), [tutorials](https://home-assistant.io/getting-started/automation/) and [documentation](https://home-assistant.io/docs/)
 
-![Screenshot](https://raw.githubusercontent.com/home-assistant/core/master/docs/screenshots.png)
\ No newline at end of file
+![Screenshot](https://raw.githubusercontent.com/home-assistant/core/master/docs/screenshots.png)
+
+## Migration
+
+February 2024
+
+This version of Home Assistant can not be exposed. To migrate to the exposable app, follow these steps:
+
+- stop the installed app
+- rename `runtipi/app-data/homeassistant` to `runtipi/app-data/__homeassistant`
+- uninstall the app
+- install Home Assiatant from the App Store
+- do NOT start the app
+- remove `runtipi/app-data/homeassistant-1`
+- rename `runtipi/app-data/__homeassistant` to `runtipi/app-data/homeassistant-1`
+- add the following section to `runtipi/app-data/homeassistant/data/config/configuration.yaml`
+  ```
+  http:
+  use_x_forwarded_for: true
+  trusted_proxies:
+    - 127.0.0.1
+    - 172.16.0.0/12
+    - ::1
+  ```
+- change `APP_ID=homeassistant` to `APP_ID=homeassistant-1` in `runtipi/app-data/homeassistant/app.env`
+- change `APP_DATA_DIR={{ROOT_FOLDER_HOST}}/app-data/homeassistant` to `APP_DATA_DIR={{ROOT_FOLDER_HOST}}/app-data/homeassistant-1` in `runtipi/app-data/homeassistant/app.env`
+- start the app
\ No newline at end of file