2021-07-01 16:09:53 +01:00
|
|
|
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-networkmanager">
|
|
|
|
<title>NetworkManager</title>
|
|
|
|
<para>
|
|
|
|
To facilitate network configuration, some desktop environments use
|
|
|
|
NetworkManager. You can enable NetworkManager by setting:
|
|
|
|
</para>
|
|
|
|
<programlisting language="bash">
|
|
|
|
networking.networkmanager.enable = true;
|
|
|
|
</programlisting>
|
|
|
|
<para>
|
|
|
|
some desktop managers (e.g., GNOME) enable NetworkManager
|
|
|
|
automatically for you.
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
All users that should have permission to change network settings
|
|
|
|
must belong to the <literal>networkmanager</literal> group:
|
|
|
|
</para>
|
|
|
|
<programlisting language="bash">
|
|
|
|
users.users.alice.extraGroups = [ "networkmanager" ];
|
|
|
|
</programlisting>
|
|
|
|
<para>
|
|
|
|
NetworkManager is controlled using either <literal>nmcli</literal>
|
|
|
|
or <literal>nmtui</literal> (curses-based terminal user interface).
|
|
|
|
See their manual pages for details on their usage. Some desktop
|
|
|
|
environments (GNOME, KDE) have their own configuration tools for
|
|
|
|
NetworkManager. On XFCE, there is no configuration tool for
|
|
|
|
NetworkManager by default: by enabling
|
2021-07-04 02:56:26 +01:00
|
|
|
<xref linkend="opt-programs.nm-applet.enable" />, the graphical
|
|
|
|
applet will be installed and will launch automatically when the
|
|
|
|
graphical session is started.
|
2021-07-01 16:09:53 +01:00
|
|
|
</para>
|
|
|
|
<note>
|
|
|
|
<para>
|
|
|
|
<literal>networking.networkmanager</literal> and
|
|
|
|
<literal>networking.wireless</literal> (WPA Supplicant) can be
|
|
|
|
used together if desired. To do this you need to instruct
|
|
|
|
NetworkManager to ignore those interfaces like:
|
|
|
|
</para>
|
|
|
|
<programlisting language="bash">
|
|
|
|
networking.networkmanager.unmanaged = [
|
|
|
|
"*" "except:type:wwan" "except:type:gsm"
|
|
|
|
];
|
|
|
|
</programlisting>
|
|
|
|
<para>
|
|
|
|
Refer to the option description for the exact syntax and
|
|
|
|
references to external documentation.
|
|
|
|
</para>
|
|
|
|
</note>
|
|
|
|
</section>
|