From a9b581bb30e179024830564c0db570426462ee61 Mon Sep 17 00:00:00 2001 From: Stefan Date: Thu, 20 Aug 2020 20:29:49 +0200 Subject: [PATCH 1/2] - fixed grammar and spelling mistakes - added VNC keymaps clarification and image --- img/vnc-keymaps.png | Bin 0 -> 4578 bytes pages/vnc.md | 19 ++++++++++++------- 2 files changed, 12 insertions(+), 7 deletions(-) create mode 100644 img/vnc-keymaps.png diff --git a/img/vnc-keymaps.png b/img/vnc-keymaps.png new file mode 100644 index 0000000000000000000000000000000000000000..fb9d51e3c71a9db9d04497ba61ea5e07bbcd7b61 GIT binary patch literal 4578 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 literal 0 HcmV?d00001 diff --git a/pages/vnc.md b/pages/vnc.md index b8acb3a..e03633e 100644 --- a/pages/vnc.md +++ b/pages/vnc.md @@ -1,16 +1,21 @@ # VNC As an alternative to the web interface, you can use VNC with various desktop clients. The main advantage of VNC over the browser is the ability to expand the image to the full screen, as well as complete interception of all keyboard keys. In some cases, VNC will be more responsive than the browser, especially on weak computers. -**Please note: we strongly don't recomment the use of VNC in untrusted networks.** The current implementation uses either weak TLS encryption or no encryption at all (depending on your client). In the latter case, your password will be transmitted over the network in plain text. Unfortunately, this is the reality of the VNC protocol. +:exclamation: **Please note: we strongly adivse against using VNC in untrusted networks! (i.e. Internet, public WiFi and similar networks)** +The current VNC implementation uses either weak TLS encryption or no encryption at all (depending on your client). In the latter case, your password will be transmitted over the network in plain text. Unfortunately, this is the reality of the VNC protocol. # Enabling VNC on the Pi-KVM side -1. Switch Pi-KVM filesystem to the read-write mode using command `rw`. -2. Optional: change client's keyboard layout if you're using an non-US keyboard. To do this edit file `/etc/kvmd/override.yaml` (remove `{}` before adding lines): +1. Switch Pi-KVM filesystem to read-write mode using command `rw`. +2. _Optional:_ Change client's keyboard layout if you're using an non-US keyboard. To do this edit file `/etc/kvmd/override.yaml` +:exclamation: **(remove `{}` before adding lines)**: ```yaml vnc: keymap: /usr/share/kvmd/keymaps/ru ``` -3. Optional: some VNC clients (for example TightVNC) can't use user/password authentication. In this case you can enable passhrases mode in `/etc/kvmd/override.yaml`: + _All available keymaps are located in /usr/share/kvmd/keymaps:_ + ![VNC keymaps](/img/vnc-keymaps.png) + +3. _Optional:_ Some VNC clients (for example TightVNC) can't use user/password authentication. In this case you can enable passhrases mode in `/etc/kvmd/override.yaml`: ```yaml vnc: auth: @@ -19,11 +24,11 @@ As an alternative to the web interface, you can use VNC with various desktop cli ``` To set passphrases edit file `/etc/kvmd/vncpasswd`. 4. Enable `kvmd-vnc` daemon. VNC will be available on the port 5900: `systemctl enable --now kvmd-vnc`. -5. Switch filesystem to the read-only: `ro`. +5. Switch filesystem back to read-only: `ro`. # Configuring the client -We recommend [TigerVNC](https://tigervnc.org) for the better experience. -Here the settings for this client: +We recommend [TigerVNC](https://tigervnc.org) for a better experience. +Here are our recommended settings for TigerVNC: * **Compression** tab: - Choose **Tight** encoding as preferred and color-level **Full**. - Disable automatic quality adjust settings **Auto Select**. From 28d91515a7708e95fdc86be86507bb97ce8b09da Mon Sep 17 00:00:00 2001 From: Stefan <11146296+tryallthethings@users.noreply.github.com> Date: Thu, 20 Aug 2020 20:31:47 +0200 Subject: [PATCH 2/2] Update vnc.md --- pages/vnc.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/pages/vnc.md b/pages/vnc.md index e03633e..526b983 100644 --- a/pages/vnc.md +++ b/pages/vnc.md @@ -2,12 +2,14 @@ As an alternative to the web interface, you can use VNC with various desktop clients. The main advantage of VNC over the browser is the ability to expand the image to the full screen, as well as complete interception of all keyboard keys. In some cases, VNC will be more responsive than the browser, especially on weak computers. :exclamation: **Please note: we strongly adivse against using VNC in untrusted networks! (i.e. Internet, public WiFi and similar networks)** + The current VNC implementation uses either weak TLS encryption or no encryption at all (depending on your client). In the latter case, your password will be transmitted over the network in plain text. Unfortunately, this is the reality of the VNC protocol. # Enabling VNC on the Pi-KVM side 1. Switch Pi-KVM filesystem to read-write mode using command `rw`. -2. _Optional:_ Change client's keyboard layout if you're using an non-US keyboard. To do this edit file `/etc/kvmd/override.yaml` -:exclamation: **(remove `{}` before adding lines)**: +2. _Optional:_ Change client's keyboard layout if you're using an non-US keyboard. To do this edit file `/etc/kvmd/override.yaml` + + :exclamation: **(remove `{}` before adding lines)**: ```yaml vnc: keymap: /usr/share/kvmd/keymaps/ru