Front matter, what's in the box, config update for material, placeholders

This commit is contained in:
Aleksandr Prokudin 2025-03-10 16:27:01 +01:00
parent 74d118c394
commit 12f6cb5a2d
2 changed files with 62 additions and 9 deletions

View File

@ -98,28 +98,79 @@ TBD
![MISSING POWER IMAGE](power-up.jpg)
Use the power supply and turn on PiKVM. The Mini comes with USB-C 5V power supply, and Plus with Barrel 12V. Use the appropriate connector on the **front** side. Please note that Plus can also work from 5V, in this case, do not connect a 12V power supply and don't create a significant power load on USB (external flash sticks, cameras, and so on).
V4 Mini and V4 Plus have different power supplies:
**Do not** block the ventilation holes on the sides of the device. This is especially important for the V4 Plus, which has an active cooling.
- The Mini comes with USB-C 5V power supply
- The Plus comes with with Barrel 12V
Wait until PiKVM starts and shows a greeting on the built-in display. **Do not** turn off the device until it's fully booted for the first time.
The Plus can also work from 5V. In that case, avoid creating a significant power load on USB (external flash sticks, cameras, and so on).
## Update the OS
Attach the appropriate connector on the **front** side. Do **not** block the ventilation holes on the sides of the device.
After turning on the power, PiKVM OS generates unique SSH keys and certificates and performs all necessary operations on the memory card. It takes a few minutes. Do **not** turn off the device until it's fully booted for the first time. Once it's done, the PiKVM will show a greeting on the built-in display.
![MISSING GREETING IMAGE](greeting.jpg)
## Connect and set up
### Obtain IP address
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`.
### Connect via SSH
Type the URL in the browser's address bar and press Enter: https://192.168.0.100/ or https://pikvm/.
### Change the default passwords
![MISSING LOGIN SCREEN](log-in-form.png)
Submit the default credentials: use `admin` for both the user name and the password.
![MISSING LOGIN SCREEN](log-in-form.png)
### Open the web UI
### Connect to the target system
TODO
### Change the default passwords
For security's sake, it's best to change the default passwords immediately after running PiKVM for the first time. To do that:
1. Open the web terminal
![MISSING SCREENSHOT](web-terminal.png)
2. Gain superuser privileges, use `root` for password:
```console
$ su -
```
3. Run `rw` to change the access to the SD card to the write mode:
```console
[root@pikvm ~]# rw
```
4. Change the password for the superuser:
```console
[root@pikvm ~]# passwd root
```
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:
### Open a remote session
TODO
## Further steps
### Update the OS
You can immediately [update](_update_os.md) to the latest version of the PiKVM operating system or skip to the next step.
### Get to know the interface
Read [this help section](webui.md) to better understand all the possibilities of the web user interface.
@ -173,7 +224,7 @@ The V4 Plus has an internal USB port. It supports USB 3.0, but only works with U
### HDMI pass-through
You can pass the signal from the host device to its physical display through V4 Plus. Only resolutions of up to 1080p are supported. [See here](pass.md) for the guide.
You can pass the signal from the host device to its physical display through V4 Plus. Only resolutions of up to 1920x1200 pixels are supported. [See here](pass.md) for the guide.
### DIP switches

View File

@ -46,6 +46,8 @@ markdown_extensions:
- pymdownx.details
- pymdownx.superfences
- pymdownx.magiclink
- pymdownx.tabbed:
alternate_style: true
- toc:
permalink: true
- codehilite: