Chapter 8. Configuring IP networking with nmtui
The following section provides how you can configure a network interface using the
8.1. Getting started with nmtui
nmtui is a simple curses-based text user interface (TUI) for
This procedure describes how to start the text user interface tool,
The nmtui tool is used in a terminal window. It is contained in the NetworkManager-tui package, but it is not installed along with NetworkManager by default. To install NetworkManager-tui:
yum install NetworkManager-tui
- To verify that NetworkManager is running, see Section 5.3, “Checking the status of NetworkManager”
Start the nmtui tool:
The text user interface appears.
- To navigate, use the arrow keys or press Tab to step forwards and press Shift+Tab to step back through the options. Press Enter to select an option. The Space bar toggles the status of a check box.
8.1.1. Adding a connection profile using nmtui
nmtui application provides a text user interface to NetworkManager. This procedure describes how to add a new connection profile.
NetworkManager-tuipackage is installed.
Start the NetworkManager text user interface utility:
Edit a connectionmenu entry, and press Enter.
- Select the Enter. button, and press
Ethernet, and press Enter.
Fill the fields with the connection details.
- Select to save the changes.
Backto return to the main menu.
Activate a connection, and press Enter.
- Select the new connection entry, and press Enter to activate the connection.
- Select to return to the main menu.
Display the status of the devices and connections:
# nmcli device status DEVICE TYPE STATE CONNECTION enp7s0 ethernet connected Example-Connection
To display all settings of the connection profile:
# nmcli connection show Example-Connection connection.id: Example-Connection connection.uuid: b6cdfa1c-e4ad-46e5-af8b-a75f06b79f76 connection.stable-id: -- connection.type: 802-3-ethernet connection.interface-name: enp7s0 ...
- For more information on testing connections, see Chapter 36, Testing basic network settings.
For further details about the
nmtuiapplication, see the
- If the configuration on the disk does not match the configuration on the device, starting or restarting NetworkManager creates an in-memory connection that reflects the configuration of the device. For further details and how to avoid this problem, see NetworkManager duplicates a connection after restart of NetworkManager service.
8.1.2. Applying changes to a modified connection with nmtui
To apply changes after a modified connection which is already active requires a reactivation of the connection. In this case, follow the procedure below:
Activate a connectionmenu entry.
Figure 8.2. Activating a connection with nmtui
Select the modified connection. On the right, click the
Figure 8.3. Deactivating a modified connection with nmtui
Choose the connection again and click the
Figure 8.4. Reactivating a modified connection with nmtui
The following commands are also available:
If no connection name is supplied, the selection menu appears. If the connection name is supplied and correctly identified, the relevant
Edit connection screen appears.
If no connection name is supplied, the selection menu appears. If the connection name is supplied and correctly identified, the relevant connection is activated. Any invalid command prints a usage message.
Note that nmtui does not support all types of connections. In particular, you cannot edit VPNs, wireless network connections using WPA Enterprise, or Ethernet connections using
- For more information about the NetworkManager’s tools, see Section 5.5, “NetworkManager tools”