Skip to content

config/network/networkmanager: clarify need for polkit and DNS config #911

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
abrumsen wants to merge 1 commit into
base: master
Choose a base branch
from
Open

config/network/networkmanager: clarify need for polkit and DNS config #911

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion src/config/network/networkmanager.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,21 @@ Also ensure that the `dbus` service is [enabled](../services/index.md) and
running. NetworkManager uses `dbus` to expose networking information and a
control interface to clients, and will fail to start without it.

NetworkManager uses `resolvconf` from the `openresolv` package to manage DNS
configuration by default. If `/etc/resolv.conf` is already a symlink or is
managed by another service, NetworkManager may not manage it as expected. Check
and remove or adjust the existing resolver configuration before switching to
NetworkManager.

Finally, enable the `NetworkManager` service.

## Configuring NetworkManager

Users of NetworkManager must belong to the `network` group.
NetworkManager uses polkit to authorize network management operations performed
by unprivileged users. The `NetworkManager` package provides a polkit rule that
grants these permissions to members of the `network` group. Install the `polkit`
package, [enable](../services/index.md) the `polkitd` service, and add the user
to the `network` group.

The `NetworkManager` package includes a command line tool,
[nmcli(1)](https://man.voidlinux.org/nmcli.1), and a text-based user interface,
Expand Down
Loading