From aca0a73c427d603c29e6eb125a478a644d2f1ef0 Mon Sep 17 00:00:00 2001
From: Markus Zehnder <business@markuszehnder.ch>
Date: Fri, 17 Mar 2023 16:03:58 +0100
Subject: [PATCH] fix: Simulator-VM: https image loading in remote-ui

---
 CHANGELOG.md              |  3 +++
 docker/docker-compose.yml |  2 ++
 linux-vm/README.md        |  1 +
 linux-vm/install.md       | 22 ++++++++++++++++++++++
 4 files changed, 28 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 50ef968..954d643 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 _Changes in the next release_
 
+### Fixed
+- Simulator-VM: https image loading in remote-ui. Required OpenSSL 1.1.1 libraries were missing.
+
 ---
 
 ## v0.22.1-alpha - 2023-03-15
diff --git a/docker/docker-compose.yml b/docker/docker-compose.yml
index 03b378b..8334994 100644
--- a/docker/docker-compose.yml
+++ b/docker/docker-compose.yml
@@ -12,6 +12,8 @@ services:
       - "8443:8443"
     environment:
       - UC_TOKEN_PATH=/tmp/ui-env/ws-token
+# To run the simulator on the same network as the host. Existing Docker integrations must be reconfigured!
+#    network_mode: "host"
     volumes:
       - simulator-data:/data
       - ./ui-env:/tmp/ui-env
diff --git a/linux-vm/README.md b/linux-vm/README.md
index be0ea3e..bd930fc 100644
--- a/linux-vm/README.md
+++ b/linux-vm/README.md
@@ -25,6 +25,7 @@ Installed applications & tools:
 - Home Assistant Server
 - mkcert
 - Qt 5.15.2
+- Node.js 18
 - VirtualBox guest additions
 
 Installed Remote Two applications:
diff --git a/linux-vm/install.md b/linux-vm/install.md
index 939e7b3..b0c9ba1 100644
--- a/linux-vm/install.md
+++ b/linux-vm/install.md
@@ -107,6 +107,23 @@ Notes:
 - Most Qt modules are already included in the default installation and therefore not included in the module parameter.
 - See [aqtinstall docs](https://aqtinstall.readthedocs.io/en/latest/getting_started.html) for further information.
 
+### Ubuntu 22.04: downgrade OpenSSL to v1.1.1
+
+Ubuntu 22.04 comes with OpenSSL v3 which doesn't work with QNetworkManager in the aqtinstall version 5.15.2.
+Install OpenSSL v1.1.1:
+```bash
+wget http://security.ubuntu.com/ubuntu/pool/main/o/openssl/openssl_1.1.1f-1ubuntu2.17_amd64.deb
+wget http://security.ubuntu.com/ubuntu/pool/main/o/openssl/libssl-dev_1.1.1f-1ubuntu2.17_amd64.deb
+wget http://security.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2.17_amd64.deb
+
+sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2.17_amd64.deb
+sudo dpkg -i libssl-dev_1.1.1f-1ubuntu2.17_amd64.deb
+sudo dpkg -i openssl_1.1.1f-1ubuntu2.17_amd64.deb
+```
+
+⚠️ only downgrade OpenSSL on a dedicated machine / VM and never in a shared or production environment!
+This will most likely break other apps!
+
 ### Configure Environment
 
 Some environment variables need to be set for the installed Qt runtime. `aqtinstall` will not set them automatically, to
@@ -216,3 +233,8 @@ Install Firecamp for WebSocket API testing:
 sudo snap install firecamp
 ```
 
+Install Node.js for integration driver development:
+```bash
+curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - &&\
+sudo apt-get install -y nodejs
+```