public_git
/
pikvm
mirror of https://github.com/pikvm/pikvm.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

update

This commit is contained in:
Maxim Devaev 2023-12-03 14:01:03 +02:00
parent 42f1a9d2ac
commit 060cecd0b2
2 changed files with 24 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/_diy_wiring_atx.md
View File

@ -7,7 +7,7 @@ All you have to do is connect the PiKVM ATX controller to their wires by making
Please note that the pinout differs on different motherboards, so before you continue, Please note that the pinout differs on different motherboards, so before you continue,
check the documentation on your motherboard for correct pinout. check the documentation on your motherboard for correct pinout.
The following illustration shows how the connection between the power led and the power button should be performed. The following illustration shows how the connection between the power LED and the power button should be performed:
<img src="../_diy/atx_connection.png" width="500"/> <img src="../_diy/atx_connection.png" width="500"/>
@ -16,4 +16,4 @@ and on the right are the LED and button of the target host. The implementation o
and can be performed, for example, by cutting wires and performing twisting, followed by insulation with duct tape. and can be performed, for example, by cutting wires and performing twisting, followed by insulation with duct tape.
Be careful and respect the polarity of the LEDs. The polarity of the button does not matter (they have no polarity at all). Be careful and respect the polarity of the LEDs. The polarity of the button does not matter (they have no polarity at all).
The connection of HDD led and reset switch is performed in the same way. The connection of HDD LED and reset switch is performed in the same way.

33
docs/first_steps.md
View File

@ -4,8 +4,8 @@
----- -----
## First power on ## First power on
1. Optional: [setting up Wi-Fi](on_boot_config.md) before booting.<br> 1. Optional: [setting up Wi-Fi or static IP](on_boot_config.md) before booting.<br>
*There is nothing more reliable than wired Ethernet, so it's better to use a cable.* *Remember that there is nothing more reliable than wired Ethernet.*
2. **Power up the device.** 2. **Power up the device.**
@ -17,33 +17,43 @@
----- -----
## Getting access to PiKVM ## Getting access to PiKVM
By default, PiKVM receives a dynamic IP address via DHCP. PiKVM V3+ devices shows the IP address on the built-in OLED display. By default, PiKVM receives a dynamic IP address via DHCP. PiKVM V3+ devices show it on the built-in OLED display.
??? example "PiKVM without OLED: finding device in the network" ??? example "PiKVM without OLED: finding device in the network"
To determine the IP address of your PiKVM, use one of the following methods: To determine the IP address of your PiKVM, use one of the following methods:
* **Common way:** Open the web interface of your router and find the list of issued IP addresses there. It depends on the router model. * **Common way:** Open the web interface of your router and find the list of issued IP addresses there.
* **Linux-only:** Use command `arp-scan --localnet`. * **Linux-only:** Use command `arp-scan --localnet`.
* **Linux, MacOS, Windows:** Download and run [Angry IP Scanner](https://angryip.org). * **Linux, MacOS, Windows:** Download and run [Angry IP Scanner](https://angryip.org).
* **Windows PowerShell:** Use command `arp -a`. * **Windows PowerShell:** Use command `arp -a`.
In order to find PiKVM using the ARP commands, you need to look for the following MAC Address's: `B8:27:EB`, `DC:A6:32` or `E4:5F:01`. In order to find PiKVM using the ARP commands, you need to look for the following MACs: `B8:27:EB`, `DC:A6:32` or `E4:5F:01`.
For future examples, let's assume that PiKVM has received the address `192.168.0.100`, For future examples, let's assume that PiKVM has received the address `192.168.0.100`,
which you have successfully detected using the instructions above. The device has also been assigned a hostname `pikvm`. which you have successfully detected using the instructions above. The device has also been assigned a hostname `pikvm`.
??? example "Access to PiKVM Web Interface" ??? example "Access to PiKVM Web Interface"
In *most* networks you should be able to reach PiKVM via any browser with the URL `https://192.168.0.100/` OR `https://pikvm/`.
Google Chrome (Chromium), Firefox and Safari work best without any extensions enabled, if one works but the other does not,
this might be a browser/extension issue. It is advised you use private window or incognito mode.
Internet Explorer and the pre-Chromium version of Microsoft Edge are not supported.
**The default user is `admin`, the password is also `admin`, and no 2FA code.** After logging in, you will get access to the menu with the main functions. Using the Web Terminal, you can change system settings and passwords. * **We recommend using the latest Google Chrome or Chromium**, as they support the largest number of PiKVM features.
* Safari and Firefox are in second place.
* Internet Explorer and the pre-Chromium versions of Microsoft Edge are not supported.
*The latest versions of Chrome on Mac OS do not allow access to the page with a self-signed certificate, which is used in PiKVM by default. You can proceed by typing `thisisunsafe` and Chrome will then load the page.* For the first time, it is better to use a browser without extensions or incognito mode,
as some extensions may disrupt the work of PiKVM.
Type the URL in the browser's address bar and press Enter: `https://192.168.0.100/` or `https://pikvm/`.
**The default user is `admin`, the password is also `admin`, and no 2FA code.**
After logging in, you will get access to the menu with the main functions.
Using the Web Terminal, you can change system settings and passwords.
*The latest versions of Google Chrome on Mac OS do not allow access to the page with a self-signed certificate,
which is used in PiKVM by default. You can proceed by typing `thisisunsafe` and Chrome will then load the page.*
??? example "Access to PiKVM via SSH" ??? example "Access to PiKVM via SSH"
SSH is the most common remote access method in the Linux world. PiKVM is accessible via SSH. This method is used to manage the device: SSH is the most common remote access method in the Linux world. PiKVM is accessible via SSH. This method is used to manage the device:
* **Linux, MacOS:** Open any terminal application and run: `ssh root@192.168.0.100` or `ssh root@pikvm`. * **Linux, MacOS:** Open any terminal application and run: `ssh root@192.168.0.100` or `ssh root@pikvm`.
@ -52,6 +62,7 @@ which you have successfully detected using the instructions above. The device ha
**The default `root` password is `root`.** **The default `root` password is `root`.**
!!! tip "Obtaining root access" !!! tip "Obtaining root access"
* If you have logged in via SSH, then most likely you are already `root`. * 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 get `root` in the Web Terminal, use command `su -` and enter the root password.