mirror of
https://github.com/pikvm/pikvm
synced 2024-11-06 21:20:32 +00:00
58 lines
2.8 KiB
Markdown
58 lines
2.8 KiB
Markdown
# 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](building_os.md).
|
|
|
|
|
|
## Using Linux CLI
|
|
Decompress and flash image and follow to the [final steps](#the-final-steps). Be careful be careful when choosing your device path:
|
|
```bash
|
|
$ bzip2 -d v2-hdmi-rpi4.img.bz2
|
|
$ sudo dd if=v2-hdmi-rpi4.img of=/dev/mmcblk0
|
|
```
|
|
|
|
|
|
## Using Balena Etcher (Linux, MacOS and Windows)
|
|
1. Download and install [Balena Etcher](https://www.balena.io/etcher).
|
|
|
|
2. The downloaded OS image is compressed. Balena Etcher can flash compressed images, but it consumes more RAM and this process slower than with uncompressed image. If possible, we recommend you to decompress the image (from `*.img.bz2` to `*.img` file). You can do this using any archiver or your file manager. If you don't have any archiver (on Windows for example) - the [7-Zip](https://www.7-zip.org) is a great choice.
|
|
|
|
3. Run Balena Etcher:
|
|
|
|
<img src="../img/balena-1.png" alt="drawing" height="300"/>
|
|
|
|
4. Press **Flash from file** and choose the compressed or uncompressed image:
|
|
|
|
<img src="../img/balena-2.png" alt="drawing" height="300"/>
|
|
|
|
5. Insert memory card to the card reader. Press **Select target** and choose your memory card:
|
|
|
|
<img src="../img/balena-3.png" alt="drawing" height="300"/>
|
|
|
|
6. Press **Flash!** button.
|
|
|
|
<img src="../img/balena-4.png" alt="drawing" height="300"/>
|
|
|
|
7. Wait for the finish. If an error occurs during flashing, repeat the process:
|
|
|
|
<img src="../img/balena-5.png" alt="drawing" height="300"/>
|
|
|
|
|
|
## The final steps
|
|
1. 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.
|
|
|
|
2. After power-up, Pi-KVM OS generates unique SSH keys and certificates. Do not turn off the Raspberry Pi until it's fully booted.
|
|
|
|
3. Congratulations! Your Pi-KVM will be available via SSH (`ssh root@<addr>` with password `root` by default) and HTTPS (try to open in a browser the URL `https://<addr>`, the login `admin` and password `admin` by default). For HTTPS a self-signed certificate is used by default.
|
|
|
|
4. To change the root password use command `passwd` via SSH or webterm. To change Pi-KVM web password use `kvmd-htpasswd set admin`.
|
|
|
|
5. After installation, we recommend that you update your operating system:
|
|
```shell
|
|
# rw
|
|
# pacman -Syu
|
|
# reboot
|
|
```
|
|
|
|
If you have any problems or questions, contact us using Discord: https://discord.gg/bpmXfz5
|