diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 6c1775e..5c5d1e0 100644 --- a/.github/workflows/ci.yml +++ b/.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 diff --git a/docs/_passwd.md b/docs/_passwd.md new file mode 100644 index 0000000..05013ad --- /dev/null +++ b/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 # Sets a new user with password + # kvmd-htpasswd del # Removes/deletes a user + ``` + + **Optionally you can enable the [two-factor authentication](auth.md#two-factor-authentication) for more security.** diff --git a/docs/first_steps.md b/docs/first_steps.md index 99c0368..86238fd 100644 --- a/docs/first_steps.md +++ b/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! ✮ ✮ ✮" - 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 # Sets a new user with password - # kvmd-htpasswd del # Removes/deletes a user - ``` - - Optionally you can enable the [two-factor authentication](auth.md#two-factor-authentication). +{!_passwd.md!} ## Configuring PiKVM diff --git a/docs/v3.md b/docs/v3.md index dd8709b..86c7541 100644 --- a/docs/v3.md +++ b/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! :)" - How to do this was written in [the "First steps" guide](first_steps.md){target=_blank} +7. **Just reminding again:** + + {!_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). diff --git a/docs/v4.md b/docs/v4.md index b80d0cf..84c0f30 100644 --- a/docs/v4.md +++ b/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! :)" - How to do this was written in [the "First steps" guide](first_steps.md){target=_blank} +5. **Just reminding again:** + + {!_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).