NetworkManager

NetworkManager is network management software for Ethernet, WiFi, DSL, dialup, VPN, WiMAX, and mobile broadband network connections]].

Installation
NetworkManager requires an implementation of udev and D-Bus. On laptops and desktops, it is typically built with polkit to enable local users to configure it. It also optionally integrates with systemd, upower, and others.

The  USE flag will enable support for NetworkManager in other packages. Enabling this USE flag will make those packages pull in automatically:

Alternatively, the tool from  can do this from the command-line:

Kernel
For WiFi devices enable also the following options:

Look at the udev page for kernel configuration needed for this NetworkManager dependency.

Emerge
After changing use flags run the following command to update the system so the changes take effect:

To manually install NetworkManager, if not already pulled in automatically from above command:

VPN plugins
The following packages can be used to add VPN support to the base NetworkManager agent:


 * - VPN connection using OpenConnect
 * - VPN connection using
 * - VPN connection using OpenVPN server
 * - VPN connection to a PPTP server
 * - VPN connection to a SSTP server
 * - VPN connection using

After emerging a plugin, it will be available when adding new connections to NetworkManager.

GTK GUIs


There is a systray applet working in classic Xembed-based systrays provided by.

If a systray is not included as a part of the desktop environment in use, a standalone systray like can be installed. The connection editor GUI in the same package as the applet. Note that this package serves all sorts of desktop environments and panels with systrays but it is no longer used by Gnome which has its own implementations in Gnome Shell and Gnome Control Center.

Also note that the current upstream version doesn't support the appindicator API and thus does not work in some systray implementations like those in current versions of KDE and Unity or the development versions of Enlightenment.

In LXQt when setting panel to autohide and mouse hover on Wi-Fi ico hides your panel, the following are needed:


 * 1) Emerge  with USE flag appindicator
 * 2) Emerge  with USE flag statusnotifier
 * 3) Edit autostart in LXQt: change nm-applet to nm-applet --indicator.

See.

KDE GUIs

 * - KDE Plasma frontend.

User permission
On Gentoo, NetworkManager uses the group to specify which non-root users can manage system network connections (treated as pluggable devices). Be sure to add each user who should be permitted to manage the network connections to that group.

Adding user  can be achieved issuing:

OpenRC
Remove any existing network management services (if activated).

For example, to remove any netifrc scripts from controlling network interfaces (assuming they are all in the default runlevel), issue the following command:

To remove :

Start NetworkManager:

To start NetworkManager at boot time add it the default runlevel:

systemd
To start NetworkManager immediately:

Enable NetworkManager to be started at boot time:

With NetworkManager older than 0.9.10 or with services that order themselves after instead of, enabling the  for   may be necessary:

When writing custom systemd services, they can wait for NetworkManager to configure the boot time connections:

With NetworkManager 0.9.10 and later it works even without explicitly enabling the.

Setting a hostname
If NetworkManager was built with the  USE flag enabled a hostname can be set using the following command:

Checking connectivity
NetworkManager can try to reach a page on Internet when connecting to a network. For those behind a captive portal, the desktop manager can automatically open a window asking for credentials. It's automatically done since NetworkManager 1.8, but it has to be configured manually for earlier versions. To enable this feature, edit (or create) the file to look something like this:

nm-applet and X session startup
To be able to get started when starting a light X session or light desktop environment, just put the following line in the relevant user's  file:

For support, add the following lines before the previous line. This will ease password management for GnuPG, ssh and WiFi:

NetworkManager way
NetworkManager can be set up to use Dnsmasq as a local DNS server that passes the DNS queries on to a provider's DNS server. will be set to point to 127.0.0.1, where dnsmasq runs and processes the queries. This can be useful for example if an application chroots for security reasons and before doing so copies. Then it would never be informed about changes to the DNS servers as the device moves from one WiFi network to another.

Setup of dnsmasq is simple:

Dnsmasq can be configured with files in, for more information see the wiki page or the man pages of Dnsmasq.

Then restart NetworkManager.

DNSSEC
Dnsmasq can optionally validate DNSSEC data while passing through queries (must be compiled with the  USE flag). This can be accomplished by adding these lines to the NetworkManager dnsmasq config file:

The trusted anchor can be found here. After this change dnsmasq will return SERVFAIL and no DNS data if the validation fails. If the validation succeeds it sets the Authenticated Data (AD) flag. In case the domain does not support DNSSEC dnsmasq behaves as before.

If an ISP's DNS server does not forward DNSSEC data then this will fail. Uncomment the last line, but it will defy the purpose of DNSSEC. Google's server 8.8.8.8 provides DNSSEC data.

Service way
In certain system network setups, Dnsmasq should not be controlled by NetworkManager. An alterantive way they both can be used together:

And add localhost to the file:

Set up Dnsmasq, see man pages and the wiki page about Dnsmasq for details.

Don't forget to start Dnsmasq.

On systemd systems:

On OpenRC systems:

Wireguard
See the NetworkManager section of the Wireguard article for more information on adding a Wireguard tunnel to NetworkManager.

Fixing nm-applet insufficient privileges
If fails to create new networks with the error "Insufficient Privileges," then it could be a policy kit issue. Create the following file:

This lets all users in the plugdev group control network manager.

Hostname problems
The standard "keyfile" plugin does not forward the hostname in default configuration - to avoid having it changed upon network connection, add the following section to your NetworkManager.conf and enter your hostname accordingly:

Alternatively, if a hostname is set which NetworkManager considers valid (Mainly anything other than "localhost" or similar default values), the hostname fetching from DHCP servers is skipped. To set a new hostname, edit the file /etc/conf.d/hostname:

Connection sharing
Connection sharing is not working on an Ethernet connection when set to shared via.

Verify the  USE flag has been enabled for. This can quickly be performed using :

Enable the USE flag if it is disabled, then reemerge the package:

DHCPv6 Unique IDentifier (DUID)
The DUID will be generated by NetworkManager and stored as the first line in the following file:

{{FileBox|filename=/var/lib/NetworkManager/dhclient6-*.lease|lang=bash|1= default-duid "\000\001\000\001\031\012D\036<\331+m3\004"; lease6 { ... }}

To generate a DUID NetworkManager relies on the following file, which is created by systemd. This should be unique to any system.

For non-systemd users, you can use the following command from lubko on #nm irc channel @freenode.net:

NetworkManager messing with X authentication
When NetworkManager connects to a WiFi access point, it might change your hostname. If it does, it might mess with your X authentication and prevent you from launching X applications. You can verify this with.

To fix this, you can set in your config.