LinuxCommandLibrary

nmcli-radio

Control Wi-Fi hardware radio status

TLDR

Show status of Wi-Fi

$ nmcli [[r|radio]] [[w|wifi]]
copy

Turn Wi-Fi on or off
$ nmcli [[r|radio]] [[w|wifi]] [on|off]
copy

Show status of WWAN
$ nmcli [[r|radio]] [[ww|wwan]]
copy

Turn WWAN on or off
$ nmcli [[r|radio]] [[ww|wwan]] [on|off]
copy

Show status of both switches
$ nmcli [[r|radio]]
copy

Turn both switches on or off
$ nmcli [[r|radio]] [[a|all]] [on|off]
copy

SYNOPSIS

nmcli radio
nmcli radio { all | wifi | wwan | bluetooth } { on | off }

PARAMETERS

all
    Applies the operation to all available wireless radios: Wi-Fi, WWAN, and Bluetooth.

wifi
    Specifically targets and controls the Wi-Fi radio.

wwan
    Specifically targets and controls the WWAN (mobile broadband) radio.

bluetooth
    Specifically targets and controls the Bluetooth radio.

on
    Enables the specified radio(s).

off
    Disables the specified radio(s).

DESCRIPTION

nmcli radio is a specific subcommand of the nmcli (NetworkManager Command Line Interface) tool. It provides a simple yet powerful way to manage the global enabled/disabled state of various wireless radio technologies present on a system. This includes Wi-Fi, WWAN (Wireless Wide Area Network, commonly referred to as mobile broadband), and Bluetooth. Users can query the current status of these radios, or toggle their state (on/off) either individually or all at once. This functionality is essential for power management, quickly enabling or disabling wireless connectivity, or complying with airline mode requirements. It acts on the hardware's global state, not on individual network connections.

CAVEATS

Requires the NetworkManager service to be running for nmcli to function correctly.
Changes made with nmcli radio typically require root privileges or membership in a group with NetworkManager administrative permissions (e.g., network group) to take effect.
The availability and functionality of wwan and bluetooth controls depend on the presence of corresponding hardware and drivers on the system.
Disabling a radio globally with nmcli radio off will prevent any network connections using that technology from operating, regardless of their individual connection status.

QUERYING RADIO STATUS

When invoked without any arguments (i.e., nmcli radio), the command displays the current status of all known wireless radios. The output typically shows each radio (WIFI, WWAN, BLUETOOTH) and its current state (enabled or disabled).

PERSISTENCE

Changes made with nmcli radio are generally persistent across reboots, as NetworkManager remembers the last state of the radios. However, specific hardware or system configurations might override this behavior.

HISTORY

nmcli is the command-line interface for NetworkManager, a dynamic network configuration and management daemon widely adopted in Linux distributions. NetworkManager itself was initiated by Red Hat in 2004 with the goal of simplifying network setup, particularly for mobile users. The nmcli tool, including subcommands like radio, has evolved over time to provide comprehensive control over NetworkManager's functionalities from the terminal, becoming an indispensable tool for both desktop users and system administrators managing network interfaces programmatically or via scripts.

SEE ALSO

Copied to clipboard