diff --git a/docs/auth.md b/docs/auth.md index a7bd6d07..5281047d 100644 --- a/docs/auth.md +++ b/docs/auth.md @@ -126,3 +126,35 @@ In other words, **the secret is the same for all users**. To view the current QR code of the secret use command `kvmd-totp show`. To disable 2FA and remove the secret, use command `kvmd-totp del`. + + +---- +## Disable authentication +If necessary, you can disable authentication for the Web UI. + +!!! warning + + Don't do this on untrusted networks and optionally disable the Web Terminal so as not to open the shell access to PiKVM console. + You still can use SSH to access to the console. + +1. Switch filesystem to read-write mode: + + ``` + [root@pikvm ~]# rw + ``` + +2. Edit the file `/etc/kvmd/override.yaml`: + + ```yaml + kvmd: + auth: + enabled: false + ``` + +3. Restart `kvmd`, optionally disable web terminal switch filesystem to read-only mode: + + ``` + [root@pikvm ~]# systemctl restart kvmd + [root@pikvm ~]# systemctl disable --now kvmd-webterm # Optional if you have SSH access + [root@pikvm ~]# ro + ``` diff --git a/docs/faq.md b/docs/faq.md index 456d0886..a603256b 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -364,19 +364,8 @@ As a first step, we recommend carefully reading our documentation on [GitHub](ht ??? question "How do I completely disable authorization in PiKVM?" - Edit the file `/etc/kvmd/override.yaml`: - ```yaml - kvmd: - auth: - enabled: false - ``` - - ... then restart `kvmd`: - - ``` - [root@pikvm ~]# systemctl restart kvmd - ``` + See [here](auth.md). ??? question "Can I have different hostnames for each of my PiKVMs?"