public_git
/
pikvm
mirror of https://github.com/pikvm/pikvm.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

update

This commit is contained in:
Maxim Devaev 2023-08-14 15:37:22 +03:00
parent 448989fe41
commit 82aba49c8f
1 changed files with 15 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/vnc.md
View File

@ -24,10 +24,14 @@ than the browser, especially on weak client computers.
----- -----
## Enabling VNC on the PiKVM side ## Enabling VNC on the PiKVM side
1. Switch the PiKVM filesystem to read-write mode using command `rw`. 1. The recommended client is [TigerVNC](https://github.com/TigerVNC/tigervnc/releases).
2. *Optional:* Change client's keyboard layout if you're using an non-US keyboard. 2. Switch the PiKVM filesystem to read-write mode using command `rw`.
To do this edit file `/etc/kvmd/override.yaml`:
3. ??? tip "Optional for *non-TigerVNC* clients: Change the keybobard layout for non-US keyboard"
Some clients does not support direct keyboard access.
Edit the file `/etc/kvmd/override.yaml` and add your layout for the client:
```yaml ```yaml
vnc: vnc:
@ -38,9 +42,10 @@ than the browser, especially on weak client computers.
<img src="keymaps.png" /> <img src="keymaps.png" />
3. *Optional and not recommended:* This step is not nessessory if you're using TigerVNC 4. ??? warning "Optional for *non-TigerVNC* and NOT RECOMMENDED: Enable VNCAuth method"
as it uses the Web UI login and password. This step is nessessory if you're using TightVNC (don't confuse it with TigerVNC!)
Some other VNC clients (for example TightVNC) can't use this type of authentication. and some other clients that does not support the user/password auth method.
In this case you can enable single VNCAuth passphrases mode in `/etc/kvmd/override.yaml`: In this case you can enable single VNCAuth passphrases mode in `/etc/kvmd/override.yaml`:
```yaml ```yaml
@ -52,12 +57,11 @@ than the browser, especially on weak client computers.
To set passphrases edit the file `/etc/kvmd/vncpasswd`. To set passphrases edit the file `/etc/kvmd/vncpasswd`.
But once again: **this is an unsafe authorization method**, it is better to use another client, But once again: **this is an unsafe authorization method** and it is better to use TigerVNC.
for example, the already recommended TigerVNC.
4. Enable `kvmd-vnc` daemon. VNC will be available on the port 5900: `systemctl enable --now kvmd-vnc`. 5. Enable `kvmd-vnc` daemon. VNC will be available on the port 5900: `systemctl enable --now kvmd-vnc`.
5. Switch filesystem back to read-only: `ro`. 6. Switch filesystem back to read-only: `ro`.
!!! note !!! note
With enabled [2FA](auth.md#two-factor-authentication), you will need to append the one-time code With enabled [2FA](auth.md#two-factor-authentication), you will need to append the one-time code
@ -70,7 +74,7 @@ than the browser, especially on weak client computers.
----- -----
## Configuring the client ## Configuring the client
We recommend [TigerVNC](https://tigervnc.org) for a better experience on desktop. We recommend [TigerVNC](https://tigervnc.org) for a better experience on a desktop.
If you're using PiKVM V3+ or DIY based on CSI bridge, you can try If you're using PiKVM V3+ or DIY based on CSI bridge, you can try
the [latest version (>= 1.13.0) of TigerVNC with H.264 support](https://github.com/TigerVNC/tigervnc/releases). the [latest version (>= 1.13.0) of TigerVNC with H.264 support](https://github.com/TigerVNC/tigervnc/releases).