2
0
mirror of https://github.com/pikvm/pikvm synced 2024-11-18 09:25:43 +00:00
pikvm/docs/_diy_first_launch.md
Maxim Devaev d576c6f00b update
2023-10-21 09:14:27 +03:00

2.1 KiB

  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.

  2. Flash the memory card with PiKVM OS{target=_blank} and insert it to Raspberry Pi.

  3. Turn on PiKVM using a power supply. Wait ~5 minutes.
    Do not turn off the device until it's fully booted for the first time.

  4. Carefully read and follow the "First steps" guide{target=_blank}.
    It describes how to find PiKVM on the network, how to log in there, change passwords, and so on.
    Follow the steps described there and come back to this page.

  5. Just reminding again:

    {!_passwd.md!}

  6. Try to manage the computer using PiKVM with the Web Interface.
    Make sure that you get an image and both keyboard and mouse are working. If something doesn't work, check out our FAQ (it's really useful). If nothing helped, you can get support in our Discord chat.

  7. ??? note "Note for the HDMI-USB dongle"

     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
         ```
    
     * Check that everything is working.
    
  8. Configure access to PiKVM from the Internet using port forwarding or Tailscale VPN, if you need it.

  9. Explore the features of PiKVM using the site's table of contents and have fun!