passwords doc

.github/workflows/ci.yml

@@ -12,5 +12,6 @@ jobs:
       - uses: actions/setup-python@v2
         with:
           python-version: 3.x
-      - run: pip install mkdocs-material mkdocs-video markdown==3.3.7 markdown-include
+      # We're using the own fork of markdown-include because of indention
+      - run: pip install mkdocs-material mkdocs-video markdown==3.3.7 git+https://github.com/pikvm/markdown-include
       - run: mkdocs gh-deploy --force

docs/_passwd.md

@@ -0,0 +1,21 @@
+??? danger "✮ ✮ ✮ CHANGE THE PASSWORDS! ✮ ✮ ✮"
+    PiKVM comes with the following default passwords:
+
+    * **Linux admin** (SSH, etc.): user `root`, password `root`.
+    * **PiKVM Web Interface**: user `admin`, password `admin`, no 2FA code.
+
+    **These are two separate entities with independent accounts.** To change passwords, you will need to use the terminal (read below) access via SSH or Web Terminal. If you are using the Web Terminal, use the `su -` command to get root access (enter the root user password).
+
+    ```
+    # rw
+    # passwd root
+    # kvmd-htpasswd set admin
+    # ro
+    ```
+    If you require additional user for the Web UI access, use the following:
+    ```
+    # kvmd-htpasswd set <user> # Sets a new user with password
+    # kvmd-htpasswd del <user> # Removes/deletes a user
+    ```
+
+    **Optionally you can enable the [two-factor authentication](auth.md#two-factor-authentication) for more security.**

docs/first_steps.md

@@ -79,27 +79,7 @@ For future examples, let's assume that your PiKVM has received the address **192
     reboot
     ```
 
-??? danger "✮ ✮ ✮ CHANGE THE PASSWORDS! ✮ ✮ ✮"
+{!_passwd.md!}
-    PiKVM comes with the following default passwords:
-
-    * **Linux admin** (SSH, etc.): user `root`, password `root`.
-    * **PiKVM Web Interface**: user `admin`, password `admin`, no 2FA code.
-
-    **These are two separate entities with independent accounts.** To change passwords, you will need to use the terminal (read below) access via SSH or Web Terminal. If you are using the Web Terminal, use the `su -` command to get root access (enter the root user password).
-
-    ```
-    # rw
-    # passwd root
-    # kvmd-htpasswd set admin
-    # ro
-    ```
-    If you require additional user for the Web UI access, use the following:
-    ```
-    # kvmd-htpasswd set <user> # Sets a new user with password
-    # kvmd-htpasswd del <user> # Removes/deletes a user
-    ```
-
-    Optionally you can enable the [two-factor authentication](auth.md#two-factor-authentication).
 
 
 ## Configuring PiKVM

docs/v3.md

@@ -75,8 +75,9 @@ If you have a kit without a metal case, you can use our free 3D printing case dr
     ```
     And run `systemctl restart kvmd-oled`. In some cases, if you still do not see Fahrenheit being displayed, reboot the device.
 
-7. !!! danger "Just reminding again: CHANGE THE PASSWORDS! :)"
+7. **Just reminding again:**
-    How to do this was written in [the "First steps" guide](first_steps.md){target=_blank}
+
+    {!_passwd.md!}
 
 8. **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](faq.md) (it's really useful). If nothing helped, you can get support in our [Discord chat](https://discord.gg/bpmXfz5).
 

docs/v4.md

@@ -44,8 +44,9 @@
     ```
     And run `systemctl restart kvmd-oled`. In some cases, if you still do not see Fahrenheit being displayed, reboot the device.
 
-5. !!! danger "Just reminding again: CHANGE THE PASSWORDS! :)"
+5. **Just reminding again:**
-    How to do this was written in [the "First steps" guide](first_steps.md){target=_blank}
+
+    {!_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](faq.md) (it's really useful). If nothing helped, you can get support in our [Discord chat](https://discord.gg/bpmXfz5).