2014-08-24 19:18:18 +02:00
|
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
|
|
version="5.0"
|
|
|
|
xml:id="sec-networkmanager">
|
2018-05-02 01:57:09 +02:00
|
|
|
<title>NetworkManager</title>
|
2014-08-24 19:18:18 +02:00
|
|
|
|
2018-05-02 01:57:09 +02:00
|
|
|
<para>
|
2019-09-19 19:17:30 +02:00
|
|
|
To facilitate network configuration, some desktop environments use
|
|
|
|
NetworkManager. You can enable NetworkManager by setting:
|
2014-08-24 19:18:18 +02:00
|
|
|
<programlisting>
|
2018-04-05 10:43:56 +02:00
|
|
|
<xref linkend="opt-networking.networkmanager.enable"/> = true;
|
2014-08-24 19:18:18 +02:00
|
|
|
</programlisting>
|
2019-09-19 19:17:30 +02:00
|
|
|
some desktop managers (e.g., GNOME) enable NetworkManager automatically for
|
|
|
|
you.
|
2018-05-02 01:57:09 +02:00
|
|
|
</para>
|
2014-08-24 19:18:18 +02:00
|
|
|
|
2018-05-02 01:57:09 +02:00
|
|
|
<para>
|
2019-09-19 19:17:30 +02:00
|
|
|
All users that should have permission to change network settings must belong
|
|
|
|
to the <code>networkmanager</code> group:
|
2016-09-05 11:13:47 +02:00
|
|
|
<programlisting>
|
2018-06-28 23:51:06 +02:00
|
|
|
<link linkend="opt-users.users._name__.extraGroups">users.users.alice.extraGroups</link> = [ "networkmanager" ];
|
2016-09-05 11:13:47 +02:00
|
|
|
</programlisting>
|
2018-05-02 01:57:09 +02:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2019-09-19 19:17:30 +02:00
|
|
|
NetworkManager is controlled using either <command>nmcli</command> or
|
|
|
|
<command>nmtui</command> (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
|
2020-01-30 11:29:58 +01:00
|
|
|
no configuration tool for NetworkManager by default: by enabling <xref linkend="opt-programs.nm-applet.enable"/>, the
|
|
|
|
graphical applet will be installed and will launch automatically when the graphical session is started.
|
2018-05-02 01:57:09 +02:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<note>
|
|
|
|
<para>
|
2019-09-19 19:17:30 +02:00
|
|
|
<code>networking.networkmanager</code> and <code>networking.wireless</code>
|
2020-01-30 11:29:58 +01:00
|
|
|
(WPA Supplicant) can be used together if desired. To do this you need to instruct
|
|
|
|
NetworkManager to ignore those interfaces like:
|
|
|
|
<programlisting>
|
|
|
|
<xref linkend="opt-networking.networkmanager.unmanaged"/> = [
|
|
|
|
"*" "except:type:wwan" "except:type:gsm"
|
|
|
|
];
|
|
|
|
</programlisting>
|
|
|
|
Refer to the option description for the exact syntax and references to external documentation.
|
2018-05-02 01:57:09 +02:00
|
|
|
</para>
|
|
|
|
</note>
|
2014-08-24 19:18:18 +02:00
|
|
|
</section>
|