2.6 KiB
Flashing the OS image
Download the appropriate memory card image from https://pikvm.org/download.html. Select it based on the board, platform, and the video capture device you are using. For example: choose v2-hdmi-rpi4.img.bz2 for Raspberry Pi 4 with HDMI-to-CSI capture bridge.
Note: right now, pre-compiled images are only available for the Raspberry Pi 4. In all other cases, you will need to build the operating system yourself. But don't worry, it's very simple.
For Linux guru: decompress and flash image to the memory card using CLI. Be careful be careful when choosing your device path:
$ bzip2 -d v2-hdmi-rpi4.img.bz2
$ sudo dd if=v2-hdmi-rpi4.img of=/dev/mmcblk0
If you prefer a graphical interface or don't have Linux at hand install Balena Etcher. It's available for the Linux, MacOS and Windows. Follow the instructions bellow:
-
Decomress the image using your File Manager. If you don't have an archiver (on Windows for example) - the 7-Zip is a great choice.
-
Run Balena Etcher:
-
Press Flash from file and choose the image:
-
Insert memory card to the card reader. Press Select target and choose your memory card:
-
Press Flash! button.
-
Wait for the finish. If an error occurs during flashing, repeat the process:
-
When the process is complete, pull out the memory card and insert it into the Raspberry Pi. Turn the power on. Your device will obtain the IP address via DHCP automatically.
-
After power-up, Pi-KVM OS generates unique SSH keys and certificates. Do not turn off the Raspberry Pi until it's fully booted.
-
Congratulations! Your Pi-KVM will be available via SSH (
ssh root@<addr>
with passwordroot
by default) and HTTPS (try to open in a browser the URLhttps://<IP addr>
, the loginadmin
and passwordadmin
by default). For HTTPS a self-signed certificate is used by default. -
To change root password use command
passwd
via SSH or webterm. To change Pi-KVM web password usekvmd-htpasswd set admin
. -
After installation, we recommend that you update your operating system:
# rw # pacman -Syu # reboot
If you have any problems or questions, contact us using Discord: https://discord.gg/bpmXfz5