From 556ae23a2615bbba397620d03eb1477d77e595f2 Mon Sep 17 00:00:00 2001 From: Maxim Devaev Date: Thu, 13 Feb 2025 15:13:19 +0200 Subject: [PATCH] update --- docs/_passwd.md | 2 +- docs/auth.md | 2 +- docs/faq.md | 33 +++------------------------------ 3 files changed, 5 insertions(+), 32 deletions(-) diff --git a/docs/_passwd.md b/docs/_passwd.md index 22726ee4..42f9f89d 100644 --- a/docs/_passwd.md +++ b/docs/_passwd.md @@ -25,7 +25,7 @@ If you require additional user for the Web UI access, use the following: ```console - [root@pikvm ~]# kvmd-htpasswd set # Set a new user with password or change of an existing one + [root@pikvm ~]# kvmd-htpasswd add # Add a new user with password [root@pikvm ~]# kvmd-htpasswd del # Remove/delete a user ``` diff --git a/docs/auth.md b/docs/auth.md index 2e5f3041..65a006ce 100644 --- a/docs/auth.md +++ b/docs/auth.md @@ -92,7 +92,7 @@ The `admin` is a name of a default user. the Web UI and VNC, but keep in mind that they all have the same rights: ```console - [root@pikvm ~]# kvmd-htpasswd set # Sets a new user with password + [root@pikvm ~]# kvmd-htpasswd add # Add a new user with password [root@pikvm ~]# kvmd-htpasswd list # Show the list of users [root@pikvm ~]# kvmd-htpasswd del # Removes/deletes a user ``` diff --git a/docs/faq.md b/docs/faq.md index 09d59730..7ed13738 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -246,42 +246,15 @@ As a first step, we recommend carefully reading our documentation on [GitHub](ht ??? question "What is the default password? How do I change it?" - There are two types of accounts: OS and PiKVM (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`, no 2FA code. The PiKVM account cannot be used for SSH access and vice versa. - - To change passwords, use the following commands (under root): - - ```bash - su - # If you're in the webterm - rw # Switch filesystem to read-write mode - passwd root # Change OS root password - kvmd-htpasswd set admin # Change web ui admin password - ro # Back to read-only - ``` - - Optionally you can enable the [two-factor authentication](auth.md#two-factor-authentication). + See [here](auth.md). ??? question "How do I add another user?" - As stated above you need to make 2 accounts, 1 for the shell, the other for the PiKVM Web UI. - - ``` - If you require additional users for PiKVM UI, you can use the following: - # rw - # su - - # kvmd-htpasswd set # Adds a new user - # kvmd-htpasswd set # Sets the password as long as the user exists - # kvmd-htpasswd del # Removes/deletes a user - - To add a shell/terminal account: - # rw - # su - - # useradd - # passwd - ``` + See [here](auth.md#changing-the-kvm-password). ??? question "How do I get root access in the web terminal?" - The web terminal works with the account `kvmd-webterm`. This is a regular user with no administrator privileges. 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**. + See [here](auth.md#root-access-in-the-web-terminal). ??? question "Where is the PiKVM configuration located?"