From 052efff8a1e4d470f45ad7c7d77f6d202e7d3e07 Mon Sep 17 00:00:00 2001 From: Aleksandr Prokudin Date: Tue, 22 Apr 2025 15:28:26 +0200 Subject: [PATCH] Mention the mirror mode --- docs/v4.md | 36 +++++++++++++++++++++++++++--------- 1 file changed, 27 insertions(+), 9 deletions(-) diff --git a/docs/v4.md b/docs/v4.md index 2bdac523..3ae9a326 100644 --- a/docs/v4.md +++ b/docs/v4.md @@ -113,11 +113,17 @@ After turning on the power, PiKVM OS generates unique SSH keys and certificates ## Connect and set up +### Configure the display + +The operating system on your remote computer will treat PiKVM as an additional display and use it in the Extend mode by default. That's why you will see an empty desktop when you first connect. + +To avoid that, go to the display settings in your remote computer's operating system and enable the mirror mode for the external screen that you operating system identifies as PiKVM. Refer to your operating system's documentation on that. + ### Access PiKVM -By default, PiKVM receives a dynamic IP address via DHCP and shows it on the OLED display. Let's assume that PiKVM has received the address `192.168.0.100` and has also been assigned a hostname `pikvm`. +By default, PiKVM receives a dynamic IP address via DHCP and shows it on the OLED display. Let's assume that PiKVM has received the address `192.168.0.26` and has also been assigned a hostname `pikvm`. -Type the URL in the browser's address bar and press Enter: https://192.168.0.100/ or https://pikvm/. +Type the URL in the browser's address bar and press Enter: https://192.168.0.26/ or https://pikvm/. ![MISSING LOGIN SCREEN](log-in-form.png) @@ -155,25 +161,37 @@ For security's sake, it's best to change the default passwords immediately after [root@pikvm ~]# passwd root ``` + Submit the new password, retype it the second time to confirm, press Enter, and you should see this: + + ```console + passwd: password updated successfully + ``` + 5. Change the password for web access: ```console [root@pikvm ~]# kvmd-htpasswd set admin ``` -6. Run `ro` to change the access to the SD card to the read-only mode: + Submit the new password, retype it the second time to confirm, and press Enter. + +6. Run `ro` to change the access to the SD card back to the read-only mode: + + ```console + [root@pikvm ~]# ro + ``` + +7. Press **Ctrl+D** to drop the root priveleges. + +8. Go back one page in the browser. You should be back to the initial screen. ### Access the remote system -1. Open your browser, go to https://, and log in using your credentials. +1. On the initial PiKVM screen, click the KVM button to access the remote computer. ![Log into PiKVM remotely](logging-in.png) -2. Go to the "Video" tab. - - ![Log into PiKVM remotely](go-to-video-tab.png) - -3. You should now see the host system's display and interact with it remotely using a keyboard and a mouse. +2. You should now see the host system's display and interact with it remotely using a keyboard and a mouse. ![Work remotely](work-remotely.png)