Differences between revisions 1 and 11 (spanning 10 versions)
Revision 1 as of 2018-06-16 23:40:52
Size: 947
Editor: ?cipher
Comment:
Revision 11 as of 2019-12-20 01:26:54
Size: 2434
Editor: PaulWise
Comment: fixes
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
DebianPkg:iwd is a new component aiming to replace DebianPkg:wpasupplicant. Both ConnMan and NetworkManager has support for using iwd as a backend. Further information below will focus on using NetworkManager with iwd. DebianPkg:iwd is a new component aiming to potentially replace DebianPkg:wpasupplicant in the future. It is currently available in what should be considered a 'tech preview' state since debian Buster / 10. Both ConnMan and NetworkManager has support for using iwd as a backend. Further information below will focus on using NetworkManager with iwd. (Please note that iwd heavily relies on linux features which means you need a recent kernel version.)

Please consider reading the [[https://iwd.wiki.kernel.org/|Upstream Wiki]] for more in-depth and up to date information.
Line 7: Line 9:
The iwd backend is available upstream since 0.11.x but disabled by default, both at build-time and run-time. The DebianPkg:network-manager package has enabled the iwd backend at build-time since 0.11.4 (available in experimental). This means you can easily test using iwd backend just by enabling it at runtime yourself. The iwd backend is available in upstream NetworkManager since 0.11.x but disabled by default, both at build-time and run-time. The DebianPkg:network-manager package has enabled the iwd backend at build-time since 0.11.4 (available since Buster/10.0). This means you can easily test using iwd backend just by enabling it at runtime yourself.
Line 12: Line 14:
 * apt install iwd
 * configure NetworkManager to enable/use the iwd backend (instead of the wpasupplicant backend)
 * Install iwd: apt install iwd
 * configure NetworkManager to enable/use the iwd backend (instead of the wpasupplicant backend), see code snippet below.
 * Stop NetworkManager.service and ```wpa_supplicant.service```, then restart NetworkManager.service

Append the following snippet in /etc/NetworkManager/NetworkManager.conf
{{{{
[device]
wifi.backend=iwd
}}}}


Please also refer to the [[https://iwd.wiki.kernel.org/networkmanager|upstream iwd information page on NetworkManager]].
Line 17: Line 29:
As of right now the only known issue with iwd is the inability to connect to hidden SSIDs. Feedback about your success or failure with iwd is warmly welcome! As of right now the only known issue with iwd is the [[https://gitlab.freedesktop.org/NetworkManager/NetworkManager/merge_requests/285|inability to connect to hidden SSIDs]] using NetworkManager. Feedback about your success or failure with iwd is warmly welcome! Please file a bug report.

Note: Enterprise networks might not work when using official Debian kernel as it used to lack the required config options enabled. This has been fixed since linux 5.3.9-1 (see DebianBug:924705) and should be available since Bullseye. Buster users are advised to compile their own kernel if they have the need to connect to enterprise networks (or use wpa_supplicant until upgrading to Bullseye).


= Troubleshooting =

If you're having problems getting wifi working in NetworkManager with the iwd backend enabled, please make sure the iwd service is running. See '''systemctl status iwd'''

Intro

iwd is a new component aiming to potentially replace wpasupplicant in the future. It is currently available in what should be considered a 'tech preview' state since debian Buster / 10. Both ?ConnMan and NetworkManager has support for using iwd as a backend. Further information below will focus on using NetworkManager with iwd. (Please note that iwd heavily relies on linux features which means you need a recent kernel version.)

Please consider reading the Upstream Wiki for more in-depth and up to date information.

Prerequisites

The iwd backend is available in upstream NetworkManager since 0.11.x but disabled by default, both at build-time and run-time. The network-manager package has enabled the iwd backend at build-time since 0.11.4 (available since Buster/10.0). This means you can easily test using iwd backend just by enabling it at runtime yourself.

Enabling iwd backend

To enable the iwd backend you need to:

  • Install iwd: apt install iwd
  • configure NetworkManager to enable/use the iwd backend (instead of the wpasupplicant backend), see code snippet below.

  • Stop NetworkManager.service and wpa_supplicant.service, then restart NetworkManager.service

Append the following snippet in /etc/NetworkManager/NetworkManager.conf

[device]
wifi.backend=iwd

Please also refer to the upstream iwd information page on NetworkManager.

Known issues

As of right now the only known issue with iwd is the inability to connect to hidden SSIDs using NetworkManager. Feedback about your success or failure with iwd is warmly welcome! Please file a bug report.

Note: Enterprise networks might not work when using official Debian kernel as it used to lack the required config options enabled. This has been fixed since linux 5.3.9-1 (see 924705) and should be available since Bullseye. Buster users are advised to compile their own kernel if they have the need to connect to enterprise networks (or use wpa_supplicant until upgrading to Bullseye).

Troubleshooting

If you're having problems getting wifi working in NetworkManager with the iwd backend enabled, please make sure the iwd service is running. See systemctl status iwd