Usage: nmcli device wifi { ARGUMENTS | help }
![](/@@/translation-newline)
Perform operation on Wi-Fi devices.
![](/@@/translation-newline)
ARGUMENTS := [list [ifname <ifname>] [bssid <BSSID>] [--rescan yes|no|auto]]
![](/@@/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. The
![](/@@/translation-newline)
--rescan flag tells whether a new Wi-Fi scan should be triggered.
![](/@@/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 finds a
![](/@@/translation-newline)
matching connection or creates one and then activates it on a device. This
![](/@@/translation-newline)
is a command-line counterpart of clicking an SSID in a GUI client. If a
![](/@@/translation-newline)
connection for the network already exists, it is possible to bring up the
![](/@@/translation-newline)
existing profile as follows: nmcli con up id <name>. Note that only open,
![](/@@/translation-newline)
WEP and WPA-PSK networks are supported if no previous connection exists.
![](/@@/translation-newline)
It is also 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.