summaryrefslogtreecommitdiffhomepage
path: root/test/docs
diff options
context:
space:
mode:
authorDavid Lönnhager <david.l@mullvad.net>2023-09-23 10:57:21 +0200
committerDavid Lönnhager <david.l@mullvad.net>2023-10-20 11:02:56 +0200
commit774df1f8cc531c7047818a4d656f456a92f36382 (patch)
tree968c5a84fd59f4b559d369132a49140fb160d5fe /test/docs
parentea4002dba40c67184a40c57e8852ac022498f65c (diff)
downloadmullvadvpn-774df1f8cc531c7047818a4d656f456a92f36382.tar.xz
mullvadvpn-774df1f8cc531c7047818a4d656f456a92f36382.zip
Add desktop end-to-end tests
Co-authored-by: Jonathan <jonathan@mullvad.net> Co-authored-by: Markus Pettersson <markus.pettersson@mullvad.net>
Diffstat (limited to 'test/docs')
-rw-r--r--test/docs/REMOTE_MANAGEMENT.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/test/docs/REMOTE_MANAGEMENT.md b/test/docs/REMOTE_MANAGEMENT.md
new file mode 100644
index 0000000000..9555fde9d1
--- /dev/null
+++ b/test/docs/REMOTE_MANAGEMENT.md
@@ -0,0 +1,16 @@
+You can connect to a guest VM remotely by forwarding a VNC server port over SSH. QEMU comes with a
+built-in VNC server. This example starts a Debian 11 VM as the `test` user:
+
+```
+ssh -L 5933:127.0.0.1:5933 -tt $SSH_HOST "sudo -u test bash -c 'cd $TEST_APP_PATH; \
+ cargo run --bin test-manager run-vm debian11 --vnc 5933'"
+```
+
+Replace `$SSH_HOST` with the server that you wish to connect to, and `$TEST_APP_PATH` with the path
+to the copy of this repository on the server.
+
+**NOTE**: In the above example, any changes made to the image will be lost. To make permanent
+changes, remove the `-snapshot` option.
+
+Afterwards, use a VNC client such as the TigerVNC client to connect to the given port on localhost.
+In this example: `127.0.0.1:5933` \ No newline at end of file