2023-10-21 04:32:01 +00:00
|
|
|
1. Double-check the correct assembly of the device, and make sure that you have connected
|
|
|
|
|
all the necessary cables to the host: USB, HDMI and ATX.
|
2023-10-16 18:14:44 +00:00
|
|
|
|
|
|
|
|
2. [Flash the memory card with PiKVM OS](https://docs.pikvm.org/flashing_os){target=_blank}
|
|
|
|
|
and insert it to Raspberry Pi.
|
|
|
|
|
|
2023-10-21 04:32:01 +00:00
|
|
|
3. Turn on PiKVM using a power supply. Wait ~5 minutes.<br>
|
2023-10-16 18:14:44 +00:00
|
|
|
Do not turn off the device until it's fully booted for the first time.
|
|
|
|
|
|
2023-10-21 04:32:01 +00:00
|
|
|
4. **Carefully read and follow [the "First steps" guide](first_steps.md){target=_blank}.**<br>
|
|
|
|
|
It describes how to find PiKVM on the network, how to log in there, change passwords, and so on.<br>
|
2023-10-16 18:14:44 +00:00
|
|
|
**Follow the steps described there and come back to this page.**
|
|
|
|
|
|
2023-10-21 04:32:01 +00:00
|
|
|
5. **Just reminding again:**
|
|
|
|
|
|
|
|
|
|
{!_passwd.md!}
|
|
|
|
|
|
|
|
|
|
6. Try to manage the computer using PiKVM with the Web Interface.<br>
|
|
|
|
|
Make sure that you get an image and both keyboard and mouse are working.
|
|
|
|
|
If something doesn't work, check out our [FAQ](faq.md) (it's really useful).
|
|
|
|
|
If nothing helped, you can get support in our [Discord chat](https://discord.gg/bpmXfz5).
|
|
|
|
|
|
|
|
|
|
7. ??? note "Note for the HDMI-USB dongle"
|
2023-10-16 18:14:44 +00:00
|
|
|
|
|
|
|
|
Many USB video capture devices tell the server's video card that the HDMI cable is supposedly disconnected.
|
|
|
|
|
This may lead to the fact that if you boot the server without an active stream, the server will not detect
|
|
|
|
|
your capture card. This is easy to fix:
|
|
|
|
|
|
|
|
|
|
* Switch filesystem to RW-mode:
|
|
|
|
|
```console
|
|
|
|
|
[root@pikvm ~]# rw
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* Edit file `/etc/kvmd/override.yaml` and add these lines:
|
|
|
|
|
```yaml
|
|
|
|
|
kvmd:
|
|
|
|
|
streamer:
|
|
|
|
|
forever: true
|
|
|
|
|
cmd_append: [--slowdown]
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* Finish:
|
|
|
|
|
```console
|
|
|
|
|
[root@pikvm ~]# ro
|
|
|
|
|
[root@pikvm ~]# systemctl restart kvmd
|
|
|
|
|
```
|
|
|
|
|
|
2023-10-21 04:32:01 +00:00
|
|
|
* Check that everything is working.
|
2023-10-16 18:14:44 +00:00
|
|
|
|
|
|
|
|
8. Configure access to PiKVM from the Internet using [port forwarding](https://docs.pikvm.org/port_forwarding)
|
|
|
|
|
or [Tailscale VPN](https://docs.pikvm.org/tailscale), if you need it.
|
|
|
|
|
|
|
|
|
|
9. Explore the features of PiKVM using the site's table of contents and have fun!
|
