Skip to content

Commit db9ba9d

Browse files
committed
config/users-and-groups: document user choices for superuser access
Co-authored-by: 0x5c <[email protected]> closes: void-linux#765 (incorporated some of the wording here) ref: void-linux/void-packages#56055
1 parent b595ab0 commit db9ba9d

File tree

1 file changed

+29
-8
lines changed

1 file changed

+29
-8
lines changed

src/config/users-and-groups.md

Lines changed: 29 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -26,23 +26,44 @@ $ chsh -s <shell> <user_name>
2626
`<shell>` must be the path to the shell as specified by `/etc/shells` or the
2727
output of `chsh -l`, which provides a list of installed shells.
2828

29-
## sudo
29+
## Superuser Access
3030

31-
[sudo(8)](https://man.voidlinux.org/sudo.8) is installed by default, but might
32-
not be configured appropriately for your needs. It is only necessary to
33-
configure sudo if you wish to use it.
31+
By default, Void includes the [`su(1)`](https://man.voidlinux.org/man1/su.1)
32+
privilege escalation tool. Users may wish to install and configure a more
33+
featureful alternative.
3434

35-
Use [visudo(8)](https://man.voidlinux.org/visudo.8) as root to edit the
36-
[sudoers(5)](https://man.voidlinux.org/sudoers.5) file.
35+
### sudo
3736

38-
To create a superuser, uncomment the line
37+
[sudo(8)](https://man.voidlinux.org/sudo.8) is commonly used, and is highly
38+
complex. The default configuration only allows the `root` user to run privileged
39+
commands.
40+
41+
To configure sudo, use [visudo(8)](https://man.voidlinux.org/visudo.8) as root
42+
to edit the [sudoers(5)](https://man.voidlinux.org/sudoers.5) file.
43+
44+
To create a superuser, uncomment the line:
3945

4046
```
41-
#%wheel ALL=(ALL) ALL
47+
# %wheel ALL=(ALL) ALL
4248
```
4349

4450
and add users to the `wheel` group.
4551

52+
### opendoas
53+
54+
[doas(1)](https://man.voidlinux.org/man1/doas.1) is an alternative privilege
55+
escalation tool, developed for OpenBSD and ported to Linux.
56+
57+
To configure basic superuser access, create `/etc/doas.conf` as root with the
58+
contents:
59+
60+
```
61+
permit :wheel
62+
```
63+
64+
and add users to the `wheel` group. For more complex configuration, see
65+
[doas.conf(5)](https://man.voidlinux.org/man5/doas.conf.5).
66+
4667
## Default Groups
4768

4869
Void Linux defines a number of groups by default.

0 commit comments

Comments
 (0)