nmtui - Man Page
Text User Interface for controlling NetworkManager
Examples (TL;DR)
- Open the user interface:
nmtui - List available connections, with the option to activate or deactivate them:
nmtui connect - Connect to a given network:
nmtui connect name|uuid|device|ssid - Edit/Add/Delete a given network:
nmtui edit name|id - Set the system hostname:
nmtui hostname
Synopsis
nmtui-edit | nmtui edit {name | id}
nmtui-connect | nmtui connect {name | uuid | device | SSID}
nmtui-hostname | nmtui hostname
Description
nmtui is a curses-based TUI application for interacting with NetworkManager. When starting nmtui, the user is prompted to choose the activity to perform unless it was specified as the first argument.
The supported activities are:
- edit
Show a connection editor that supports adding, modifying, viewing and deleting connections. It provides similar functionality as nm-connection-editor.
For Wi-Fi connections, the Share QR... button displays a QR code that encodes the network credentials, so they can be scanned to join the network from another device. When the password is available, it is shown alongside the code; when it cannot be read (for example, due to insufficient privileges), a warning is shown instead.
- connect
Show a list of available connections, with the option to activate or deactivate them. It provides similar functionality as nm-applet.
- hostname
Set the system hostname.
Corresponding to above activities, nmtui also comes with binaries named nmtui-edit, nmtui-connect, and nmtui-hostname to skip the selection of the activities.
See Also
nmcli(1), nm-applet(1), nm-connection-editor(1), NetworkManager(8).
Referenced By
The man pages nmtui-connect(1), nmtui-edit(1) and nmtui-hostname(1) are aliases of nmtui(1).