Update faq.md

pull/285/head
Maxim Devaev 4 years ago committed by GitHub
parent d879ec0e57
commit 23d209be0f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -4,20 +4,23 @@ As a first step we recommend carefully reading our documentation on [GitHub](htt
-----
# Common questions
### Can I connect multiple servers to a single Pi-KVM?
<details>
<summary><b>Can I connect multiple servers to a single Pi-KVM?</b></summary>
<summary>Click to view</summary>
* Yes, but it will require additional work to set up. See [this page](multiport.md).
</details>
### How can I get the access to Pi-KVM in my local network over Internet?
<details>
<summary><b>How can I get the access to Pi-KVM in my local network over Internet?</b></summary>
<summary>Click to view</summary>
* You can use port forwarding for port 443 on your router if it has an external IP address. In all other cases, you can use the excellent free VPN service [Tailscale](tailscale.md), which is configured on Pi-KVM with a [few simple commands](tailscale.md).
</details>
### Can I use Pi-KVM with non-Raspberry boards (Orange, Nano, etc)?
<details>
<summary><b>Can I use Pi-KVM with non-Raspberry Pi boards (Orange, Nano, etc)?</b></summary>
<summary>Click to view</summary>
* Yes, but you will have to prepare the operating system yourself. As for the Pi-KVM software, you will need to replace some config files (such as UDEV rules). If you are a developer or an experienced system administrator, you will not have any problems with this. In addition, we are open to patches. If you need help with this, please contact us via [Discord](https://discord.gg/bpmXfz5).
</details>
@ -25,8 +28,9 @@ As a first step we recommend carefully reading our documentation on [GitHub](htt
-----
# First steps
### What is the default password? How do I change it?
<details>
<summary><b>What is the default password? How do I change it?</b></summary>
<summary>Click to view</summary>
* There are two types of accounts: OS and Pi-KVM (web interface) accounts. The system account `root` can be used for SSH/UART access and has the password `root`. The web interface account is called `admin` and has the password `admin`. The Pi-KVM account cannot be used for SSH access and vice versa.
@ -40,28 +44,32 @@ As a first step we recommend carefully reading our documentation on [GitHub](htt
```
</details>
### How do I get root access in the web terminal?
<details>
<summary><b>How do I get <i>root</i> access in the web terminal?</b></summary>
<summary>Click to view</summary>
* The web terminal works with the account `kvmd-webterm`. This is a regular user with no administrator privileges and. In addition, `sudo` and login are disabled for this user for security reasons. To get `root` access, you need to use the `su -` command (minus is important) and **enter the root password**.
</details>
### Where is the Pi-KVM configuration located?
<details>
<summary><b>Where is the Pi-KVM configuration located?</b></summary>
<summary>Click to view</summary>
* Almost all KVMD (the main daemon controlling Pi-KVM) configuration files located in `/etc/kvmd`. You can also find nginx configs and SSL certificates there. KVMD configs use [YAML](config.md) syntax. The specific platform parameters can be found in the file `/etc/kvmd/main.yaml` and **you should never edit it**. Use `/etc/kvmd/override.yaml` to redefine the system parameters.
Another files that are also not recommended for editing have read-only permissions. If you edit any of these files, you will need to manually make changes to them when you upgrade your system. You can view the current configuration and all available KVMD parameters using the command `kvmd -m`.
</details>
### I can't edit any file on Pi-KVM. Why is the system in read-only mode?
<details>
<summary><b>I can't edit any file on Pi-KVM. Why is the system in read-only mode?</b></summary>
<summary>Click to view</summary>
* The Pi-KVM file system is always mounted in read-only mode. This measure prevents it from being damaged by a sudden power outage. To change the configuration you must first switch the filesystem to write mode using the command `rw` from root. After the changes, be sure to run the command `ro` to switch it back to read-only.
</details>
### How do I update Pi-KVM with the latest software?
<details>
<summary><b>How do I update Pi-KVM with the latest software?</b></summary>
<summary>Click to view</summary>
* Pi-KVM OS is based on Arch Linux ARM and is fully updated from the repository by a regular package manager. Connect to your Pi-KVM via ssh and run:
```

Loading…
Cancel
Save