public_git
/
pikvm
mirror of https://github.com/pikvm/pikvm.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Cheatsheet: enhance the su - docs

This commit is contained in:
Aleksandr Prokudin 2025-09-21 14:26:57 +02:00
parent fae1145eea
commit b7470fca20
1 changed files with 15 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
docs/cheatsheet.md
View File

@ -15,11 +15,23 @@ Here are **first steps guides** for each PiKVM device:
??? note "Performing commands with root privileges"
To perform any command with root privileges, you need to use `su -` followed by the command. For example, to power-off PiKVM, do this:
There are two ways to perform any command with root privileges.
`[kvmd-webterm@pikvm ~]$ su - shutdown -h`
1. Gain root privileges, then perform any command.
This applies to both SSH and web terminal sessions.
`[kvmd-webterm@pikvm ~]$ su -`
After providing root account password, you will be able to run any commands as a root user as long as the session is running. Use it wisely. For example, if you need to reboot PiKVM, all you need to do is this:
`[root@pikvm ~]# reboot`
The use of `su -` applies to both SSH and web terminal sessions.
2. Use `su -c` followed by the command wrapped in apostrophes. This will perform the command with root privileges a single time, you will not gain permanent root access. This will For example, to reboot PiKVM, do this:
`[kvmd-webterm@pikvm ~]$ su -c 'reboot'
The use of `su -c` applies to both SSH and web terminal sessions.
{!_passwd.md!}