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

Mention the mirror mode

This commit is contained in:
Aleksandr Prokudin 2025-04-22 15:28:26 +02:00
parent ded363c03f
commit 052efff8a1
1 changed files with 27 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
docs/v4.md
View File

@ -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://<your-remote-access-url>, 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)