Usage: nmcli device wifi { ARGUMENTS | help }
![](/@@/translation-newline)
Perform operation on Wi-Fi devices.
![](/@@/translation-newline)
ARGUMENTS := [list [ifname <ifname>] [bssid <BSSID>]]
![](/@@/translation-newline)
List available Wi-Fi access points. The 'ifname' and 'bssid' options can be
![](/@@/translation-newline)
used to list APs for a particular interface, or with a specific BSSID.
![](/@@/translation-newline)
ARGUMENTS := connect <(B)SSID> [password <password>] [wep-key-type key|phrase] [ifname <ifname>]
[bssid <BSSID>] [name <name>] [private yes|no] [hidden yes|no]
![](/@@/translation-newline)
Connect to a Wi-Fi network specified by SSID or BSSID. The command creates
![](/@@/translation-newline)
a new connection and then activates it on a device. This is a command-line
![](/@@/translation-newline)
counterpart of clicking an SSID in a GUI client. The command always creates
![](/@@/translation-newline)
a new connection and thus it is mainly useful for connecting to new Wi-Fi
![](/@@/translation-newline)
networks. If a connection for the network already exists, it is better to
![](/@@/translation-newline)
bring up the existing profile as follows: nmcli con up id <name>. Note that
![](/@@/translation-newline)
only open, WEP and WPA-PSK networks are supported at the moment. It is also
![](/@@/translation-newline)
assumed that IP configuration is obtained via DHCP.
![](/@@/translation-newline)
ARGUMENTS := hotspot [ifname <ifname>] [con-name <name>] [ssid <SSID>]
[band a|bg] [channel <channel>] [password <password>]
![](/@@/translation-newline)
Create a Wi-Fi hotspot. Use 'connection down' or 'device disconnect'
![](/@@/translation-newline)
to stop the hotspot.
![](/@@/translation-newline)
Parameters of the hotspot can be influenced by the optional parameters:
![](/@@/translation-newline)
ifname - Wi-Fi device to use
![](/@@/translation-newline)
con-name - name of the created hotspot connection profile
![](/@@/translation-newline)
ssid - SSID of the hotspot
![](/@@/translation-newline)
band - Wi-Fi band to use
![](/@@/translation-newline)
channel - Wi-Fi channel to use
![](/@@/translation-newline)
password - password to use for the hotspot
![](/@@/translation-newline)
ARGUMENTS := rescan [ifname <ifname>] [[ssid <SSID to scan>] ...]
![](/@@/translation-newline)
Request that NetworkManager immediately re-scan for available access points.
![](/@@/translation-newline)
NetworkManager scans Wi-Fi networks periodically, but in some cases it might
![](/@@/translation-newline)
be useful to start scanning manually. 'ssid' allows scanning for a specific
![](/@@/translation-newline)
SSID, which is useful for APs with hidden SSIDs. More 'ssid' parameters can be
![](/@@/translation-newline)
given. Note that this command does not show the APs,
![](/@@/translation-newline)
use 'nmcli device wifi list' for that.