1. Optional: [setting up Wi-Fi](on_boot_config.md) before booting.<br>
*There is nothing more reliable than wired Ethernet, so it's better to use a cable.*
2. Power up the device.
2. **Power up the device.**
3. Do not turn off the device until it's fully booted for the first time.<br>
3. **Do not turn off the device until it's fully booted for the first time.**<br>
*After turning on the power, PiKVM OS will generate unique SSH keys and certificates
and perform all necessary operations on the memory card.*
and perform all necessary operations on the memory card. It takes a few minutes.*
-----
@ -52,14 +52,23 @@ For future examples, let's assume that your PiKVM has received the address **192
**The default `root` password is `root`.**
??? example "OPTIONAL: Update PiKVM software"
This part is not nessessary for a working OOB experience and should only be performed if you are physically at the PiKVM to recover it, you however, may benefit from performing the below actions. These are the instructions:
PiKVM OS often receives software updates. After installation, it makes sense to update the OS.
It's best to do this now, when you have physical access to the device, because if something goes wrong
(for example, the power goes out during the update), you will need to [reflash the memory card](flashing_os.md).
```
rw
pacman -Syu
reboot
```
!!! tip "Obtaining root access"
* If you have logged in via SSH, then most likely you are already `root`.
* To get `root` in the Web Terminal, use command `su -` and enter the root password.
To update, run these commands under the `root` user:
```console
[root@pikvm]# rw
[root@pikvm]# pacman -Syu
[root@pikvm]# reboot
```
**And then, after all...**
{!_passwd.md!}
@ -67,11 +76,7 @@ For future examples, let's assume that your PiKVM has received the address **192
-----
## Configuring PiKVM
Most of the PiKVM settings are done through configuration files. All configuration changes must be made from under the `root` user (= the administrator).
!!! tip "Obtaining root access"
* If you have logged in via SSH, then most likely you are already `root`.
* To get `root` in the Web Terminal, use command `su -` and enter the root password.
Most of the PiKVM settings are done through configuration files. All configuration changes must be made from under the `root` user (i.e. the administrator).
The PiKVM memory card is mounted in read-only mode. It protects the filesystem from damage in case of sudden power outage. To edit any files and make changes, it is necessary to remount the file system to the read-write mode.
@ -83,11 +88,13 @@ The PiKVM memory card is mounted in read-only mode. It protects the filesystem f
In this handbook, you will often find instructions for editing configuration files. The simplest and most beginner-friendly text editor is `nano`, but you can also use `vim`.
* **✮ ✮ ✮ [Raspberry Pi 4 2Gb](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/)**.<br>
*It makes no sense to buy a Pi 4 with more memory than 2Gb, since PiKVM software uses very few resources.*
* ... or [Raspberry Pi Zero 2 W](https://www.raspberrypi.com/products/raspberry-pi-zero-2-w/).<br>
*Compact and cheap, but not so reliable solution because of lack of the wired Ethernet.*
2. **MicroSD card minimum 16Gb class 10**.
2. **MicroSD card minimum 16Gb class 10**
3. **Video capture device**:
3. **Video capture device**
* **✮ ✮ ✮ [HDMI-CSI bridge based on TC358743 chip](https://www.amazon.de/Waveshare-Raspberry-Supports-Backward-Compatible/dp/B092HVP926/)**.<br>
*Supports H.264 video encoding, automatic resolution selection and the lowest possible latency.*
* ... or [HDMI-USB dongle](https://www.amazon.com/Capture-Streaming-Broadcasting-Conference-Teaching/dp/B09FLN63B3).<br>
@ -59,15 +59,17 @@
* *x1* [Raspberry Pi Zero Camera Cable](https://www.amazon.com/Arducam-Raspberry-Camera-Ribbon-Extension/dp/B085RW9K13). *Not compatible with Auvidea B101*.
* *x1* [Official USB-Micro Power Supply](https://www.amazon.com/Capture-Streaming-Broadcasting-Conference-Teaching/dp/B09FLN63B3).
5. **Optional feature: ATX controller**
5. **Optional features**
{!_diy_parts_atx.md!}
??? success "✮ ✮ ✮ ATX controller to manage the target host's power"
6. **Optional feature: VGA video capture**
{!_diy_parts_atx.md!}
If you want to capture VGA from your server instead of HDMI, buy the [VGA-to-HDMI converter](https://aliexpress.com/item/3256801728005613.html).
Some converters have issues with not supporting all resolutions and refresh rates.
??? note "VGA video capture"
If you want to capture VGA from your server instead of HDMI,
buy the [VGA-to-HDMI converter](https://aliexpress.com/item/3256801728005613.html).
Some converters have issues with not supporting all resolutions and refresh rates.
*Kit parts suitable for assembly are also on [sale in Poland](https://3mdeb.com/shop/open-source-hardware/pikvm/).*
Maxim Devaev
7 months ago
