NetworkManager

2023-05-10T15:14:48Z

LinuxPatriot1776: /* Installation */

[https://networkmanager.dev/ NetworkManager] is a program that provides automatic detection and configuration for systems to connect to networks.

== Installation ==

{{Cmd|# apk add {{Pkg|networkmanager}}}}

 

NetworkManager comes with a command line interface and a curses-based interface, <code>nmcli</code> and <code>nmtui</code> respectively or you can use a additional gui interface:

* {{Pkg|plasma-nm}} for Plasma integration and applet
* {{Pkg|network-manager-applet}} for a GTK system tray applet

 

You will need to install an additional package if you want NetworkManager to connect to wifi:
{{Cmd|# apk add {{Pkg|networkmanager-wifi}}}}

 

After installation start NetworkManager:
{{Cmd|# rc-service networkmanager start}}

 

Then set it to autostart the service on boot:
{{Cmd|# rc-update add networkmanager default}}

 

Also your user needs to be in the <code>plugdev</code> group:
{{Cmd|# adduser <YourUsername> plugdev}}

{{Note|you will need to log out for the new group to take effect}}

 

== Wireless networks ==

==== wpa_supplicant backend ====

{{Todo|([[KDE|KDE Plasma]] Desktop) find out if it is possible to prevent requesting the password for '''KDE Wallet''' on login}}

* Follow: [[Wi-Fi#wpa_supplicant]] and [[Wi-Fi#Automatic_Configuration_on_System_Boot]]
{{Note|{{Pkg|wpa_supplicant}} configuration might not be required, if it isnt it may be a good idea to have it setup just as a fallback}}

 

Now open <code>/etc/NetworkManager/NetworkManager.conf</code> in a text editor and change it to something like this:

{{Cat|/etc/NetworkManager/NetworkManager.conf|<nowiki>[main]
dhcp=internal
plugins=ifupdown,keyfile

[ifupdown]
managed=true

[device]
wifi.scan-rand-mac-address=yes
wifi.backend=wpa_supplicant</nowiki>}}

{{Note|if these options dont work on your system you can change them as necessary}}

 

Now you need to stop conflicting services:

{{Cmd|# rc-service networking stop}}
{{Cmd|# rc-service wpa_supplicant stop}}

 

Now restart NetworkManager:

{{Cmd|# rc-service networkmanager restart}}

 

Now connect to a network using one of the interfaces mentioned in [[NetworkManager#Installation|Installation]]

 

If that connects and stays connected with no issues enable the <code>networkmanager</code> service and disable the <code>networking</code> and <code>wpa_supplicant</code> boot services:

{{Cmd|# rc-update add networkmanager}}
{{Cmd|# rc-update del networking boot}}
{{Cmd|# rc-update del wpa_supplicant boot}}

 

==== iwd backend ====

NetworkManager supports wireless networks through {{Pkg|iwd}}, however, consider [https://gitlab.freedesktop.org/NetworkManager/NetworkManager/-/issues?scope=all&utf8=%E2%9C%93&state=opened&search=iwd existing issues] before using it. After installation, enable the server and restart NetworkManager:
<pre>
rc-service iwd start
rc-service networkmanager restart
</pre>

To use {{Pkg|iwd}} though, you've have to edit NetworkManager's configuration because it still defaults to {{Pkg|wpa_supplicant}} instead. Add the following to {{Path|/etc/NetworkManager/NetworkManager.conf}}:

<pre>
[device]
wifi.backend=iwd
</pre>

 

== VPN support ==
Since version 1.16, NetworkManager has support for Wireguard[https://cgit.freedesktop.org/NetworkManager/NetworkManager/tree/NEWS?id=1.16.0].

Support for other VPN types is provided by plugins. They are provided in the following packages:
* {{Pkg|networkmanager-openvpn}} for OpenVPN

== nm-applet ==
=== not authorized to control networking ===

You can enable all users to edit connections without adding polkit.
First, make the <code>conf.d</code> directory for networkmanager:

{{Cmd|# mkdir -p /etc/NetworkManager/conf.d}}

Then, add following content to <code>/etc/NetworkManager/conf.d/any-user.conf</code>:

<pre>
[main]
auth-polkit=false
</pre>

Finally, restart networkmanager:

{{Cmd|# /etc/init.d/networkmanager restart}}

[[Category:Networking]]

Alpine Linux - User contributions [en]

NetworkManager