NetworkManager UI Tools: Complete Comparison Guide

Document Purpose: Comprehensive comparison of NetworkManager's user interface tools
Target Audience: System Administrators, Network Engineers, Technical Users
Last Updated: October 2025

Executive Summary

NetworkManager provides three primary user interface tools for network configuration, each designed for different use cases and environments. This guide helps you understand what each tool offers, where they overlap, and how to choose the right tool for your specific needs.

Quick Reference: Which Tool Should I Use?

SSH into a server? → Use nmtui
Need advanced features (VPN, bonding, bridging)? → Use nm-connection-editor
Quick connection switching on desktop? → Use nm-applet
Scripting/automation? → Use nmcli (not covered in this UI guide)

1. The Three NetworkManager UI Tools

1.1 nmtui - Text User Interface

Overview

Type: Curses-based text interface (TUI)
Environment: Terminal/console (local or SSH)
Package: NetworkManager-tui (often separate from main package)
Requires: Terminal only, no X11/Wayland needed

nmtui is a menu-driven text interface that provides basic NetworkManager functionality through a simple, navigable interface accessible from any terminal.

Launch Methods

# Main menu (choose from edit/activate/hostname)
nmtui

# Directly edit connections
nmtui edit

# Directly activate/deactivate connections
nmtui connect

# Set system hostname
nmtui hostname

Key Features

Edit connection profiles (basic settings)
Create new connections (Ethernet, WiFi, Bond, Bridge, VLAN, Team)
Activate/deactivate connections
Set system hostname
Navigate with keyboard (arrow keys, Tab, Enter, Esc)
Works over SSH connections

Advantages

Works in text-only environments (servers, recovery mode)
Perfect for SSH remote administration
Simple, intuitive interface for basic tasks
Minimal resource usage
No GUI dependencies
Fast to launch and navigate

Limitations

Limited to basic connection settings
Cannot configure advanced features (802.1X, many VPN types)
No real-time connection monitoring
Cannot edit all connection parameters
Less suitable for complex networking scenarios

Supported Connection Types

Connection Type	Support Level	Notes
Ethernet	Full	All basic features available
WiFi	Full	WPA/WPA2 PSK supported
Bond	Basic	Can create but limited options
Bridge	Basic	Can create but limited options
VLAN	Good	Basic VLAN configuration
Team	Basic	Limited team configuration
VPN	No	Cannot configure VPN connections
802.1X	No	Cannot configure enterprise WiFi

Best Use Cases for nmtui:

Initial server network configuration
Remote administration via SSH
Quick hostname changes
Basic connection activation/deactivation
Emergency network recovery on systems without GUI
Headless systems (Raspberry Pi, servers)

1.2 nm-connection-editor - Full-Featured GUI Editor

Overview

Type: GTK-based graphical application
Environment: Desktop with X11 or Wayland
Package: network-manager-gnome or nm-connection-editor
Requires: X11/Wayland display server

nm-connection-editor is the full-featured graphical connection editor providing access to ALL NetworkManager connection settings and advanced features.

Launch Methods

# Launch main editor window
nm-connection-editor

# Edit specific connection
nm-connection-editor -c "connection-name"

# Can also be launched from nm-applet menu
# Or from system settings/network configuration

Key Features

Complete access to all connection parameters
Configure VPN connections (OpenVPN, PPTP, L2TP, etc.)
Advanced WiFi security (WPA Enterprise, 802.1X)
Network bonding with all modes and options
Bridge configuration with STP settings
VLAN tagging and priority
Team device configuration
IPv6 advanced settings
Static routes configuration
MTU and cloning MAC address
Firewall zone assignment

Advantages

Access to ALL NetworkManager features
User-friendly graphical interface
Comprehensive VPN support
Real-time validation of settings
Detailed tooltips and help text
Can configure advanced enterprise networking
Organized tabs for different setting categories

Limitations

Requires graphical desktop environment
Cannot be used over SSH (without X forwarding)
Higher resource usage than text tools
Requires additional packages beyond base NetworkManager
Can be overwhelming for simple tasks

Connection Type Support

Connection Type	Support Level	Notes
Ethernet	Complete	All features, including 802.1X
WiFi	Complete	All security modes including Enterprise
Bond	Complete	All bonding modes and monitoring options
Bridge	Complete	Full STP and bridge protocol settings
VLAN	Complete	All VLAN features including priority mapping
Team	Complete	All team configurations and runners
VPN (Multiple Types)	Complete	OpenVPN, PPTP, L2TP, Cisco, etc.
DSL/PPPoE	Complete	Full PPPoE configuration
Mobile Broadband	Complete	3G/4G/LTE configuration
InfiniBand	Complete	High-performance networking

Advanced Features Available

Security: 802.1X authentication, certificates, smart cards
IPv6: Full IPv6 configuration, privacy extensions, addressing modes
Routing: Static routes, routing metrics, policy routing preparation
Hardware: MAC cloning, MTU settings, device binding
Firewall: Zone assignment for firewalld integration
PPP: Compression, authentication protocols
Ethernet: Speed/duplex forcing, wake-on-LAN

Best Use Cases for nm-connection-editor:

Configuring VPN connections
Enterprise WiFi with 802.1X authentication
Complex network bonding or bridging
Advanced routing scenarios
Any time you need access to all settings
Desktop/workstation network configuration
When you need visual feedback and validation

1.3 nm-applet - System Tray Applet

Overview

Type: System tray notification area applet
Environment: Desktop with system tray support
Package: network-manager-gnome or network-manager-applet
Requires: Desktop environment with notification area

nm-applet is a lightweight system tray application that provides quick access to network connections and launches other NetworkManager tools.

Launch Method

# Usually auto-started by desktop environment
nm-applet

# Run in background
nm-applet &

# Most desktop environments start it automatically at login

Key Features

Quick view of available WiFi networks
One-click connection activation
Connection status indicators
VPN connection control
Launch nm-connection-editor
View connection information
Enable/disable networking and WiFi
Notifications for connection events

Advantages

Always accessible from system tray
Fastest way to switch connections
Visual connection status at a glance
Minimal user interaction required
Perfect for mobile/laptop users
Integrates with desktop notifications

Limitations

Not a configuration tool itself (just a launcher)
Requires desktop environment with system tray
Limited information display
Cannot create or edit connections (launches editor)
Desktop-only (no server use)

Common Actions

Task	How To
Connect to WiFi	Click applet → Select network → Enter password
Switch Ethernet	Click applet → Select wired connection
Connect VPN	Click applet → VPN Connections → Select VPN
Edit Connection	Click applet → Edit Connections (launches nm-connection-editor)
Disable WiFi	Click applet → Uncheck "Enable Wi-Fi"
View Info	Click applet → Connection Information

Best Use Cases for nm-applet:

Daily connection switching on laptops
Quick WiFi network selection
Monitoring connection status
Enabling/disabling VPN quickly
Quick access to connection editor
Mobile users who frequently change networks

2. Feature Comparison Matrix

Feature	nmtui	nm-connection-editor	nm-applet
Environment	Terminal/Console	GUI Desktop	GUI Desktop with Tray
Works over SSH	Yes	No*	No
Works without GUI	Yes	No	No
Create Connections	Yes (Basic)	Yes (All)	No (Launches Editor)
Edit Connections	Basic Only	Complete	No (Launches Editor)
Activate Connections	Yes	No	Yes
VPN Support	No	Full	Activate Only
802.1X Configuration	No	Full	No
Bond Configuration	Basic	Complete	No
Bridge Configuration	Basic	Complete	No
Static Routes	No	Yes	No
IPv6 Advanced	Basic	Complete	No
Set Hostname	Yes	No	No
WiFi Network Scanning	Yes	Yes	Yes
Connection Status	View Only	View Only	Real-time
Notifications	No	No	Yes
Quick Switching	Multi-step	No	One-click
Resource Usage	Minimal	Moderate	Minimal

*Note on SSH: nm-connection-editor can work over SSH with X11 forwarding enabled (ssh -X), but this is slow and not recommended for production use.

3. Tool Overlap and Relationship

3.1 How They Work Together

These tools are complementary, not redundant. They're designed to work together in a complete NetworkManager ecosystem:

Typical Desktop Workflow

nm-applet runs in system tray for daily use
User clicks applet to switch WiFi networks (quick access)
User needs to configure VPN → clicks "Edit Connections" in applet
nm-connection-editor launches to configure VPN
After configuration, user activates VPN through nm-applet

Typical Server Workflow

Administrator SSHs into server
Uses nmtui to configure basic network settings
For advanced features (bonding, VLANs), either:
- Uses nmcli command-line tool, or
- Edits config files in /etc/NetworkManager/system-connections/ manually

3.2 Functional Overlap

Function	Can Do It With...	Best Tool For This
Create basic Ethernet connection	nmtui, nm-connection-editor	nmtui (if on server), nm-connection-editor (if on desktop)
Connect to WiFi	nmtui, nm-connection-editor, nm-applet	nm-applet (fastest), nmtui (if no GUI)
Activate/deactivate connection	nmtui, nm-applet	nm-applet (one-click), nmtui (if no GUI)
Configure static IP	nmtui, nm-connection-editor	nmtui (simple), nm-connection-editor (with routes)
Set hostname	nmtui only	nmtui (only UI option)
Configure VPN	nm-connection-editor only	nm-connection-editor (only UI option)
Configure 802.1X	nm-connection-editor only	nm-connection-editor (only UI option)
View connection status	All three	nm-applet (real-time updates)

4. Decision Guide: Which Tool Should I Use?

Follow This Decision Tree

Do you have a graphical desktop environment?
- NO → Use nmtui (only option)
- YES → Go to step 2
Are you connected via SSH?
- YES → Use nmtui
- NO → Go to step 3
What type of task are you doing?
- Quick connection switching → Use nm-applet
- Basic configuration (DHCP, static IP, simple WiFi) → Use nmtui OR nm-connection-editor
- Advanced configuration (VPN, 802.1X, bonding, bridging) → Use nm-connection-editor
- Setting hostname → Use nmtui

4.1 Scenario-Based Recommendations

Scenario: Initial Server Setup

Recommended Tool: nmtui

Why: You're likely at the console or SSH'd in, no GUI available. nmtui provides everything needed for basic network setup including hostname.

Scenario: Configuring Office WiFi with WPA2-Enterprise

Recommended Tool: nm-connection-editor

Why: Requires 802.1X configuration with certificates/authentication that nmtui cannot handle.

Scenario: Laptop User Switching Between Home, Work, and Coffee Shop WiFi

Recommended Tool: nm-applet

Why: One-click network switching, always visible in system tray, fastest workflow.

Scenario: Setting Up Network Bond for High Availability

Recommended Tool: nm-connection-editor (desktop) or nmcli (server)

Why: nmtui supports basic bonding but lacks advanced options like monitoring configuration. nm-connection-editor provides complete access to all bonding modes and parameters.

Scenario: Connecting to Company VPN

Initial Setup: nm-connection-editor
Daily Use: nm-applet

Why: Use editor to configure VPN initially (credentials, certificates, settings), then use applet for quick connect/disconnect daily.

Scenario: Raspberry Pi Headless Setup

Recommended Tool: nmtui

Why: No desktop environment, accessed via SSH or direct console. Perfect nmtui use case.

Scenario: Configuring Complex Static Routes

Recommended Tool: nm-connection-editor or nmcli

Why: nmtui cannot configure static routes. Need full-featured tool.

5. Installation and Availability

5.1 Package Requirements

Red Hat / CentOS / Fedora

# Base NetworkManager (includes nmcli)
sudo dnf install NetworkManager

# Text UI
sudo dnf install NetworkManager-tui

# Graphical tools
sudo dnf install network-manager-applet

Debian / Ubuntu

# Base NetworkManager
sudo apt install network-manager

# Text UI (often included)
sudo apt install network-manager

# Graphical tools
sudo apt install network-manager-gnome

Arch Linux

# Base and text UI
sudo pacman -S networkmanager

# Graphical tools
sudo pacman -S network-manager-applet

5.2 Checking What's Installed

# Check for nmtui
which nmtui

# Check for nm-connection-editor
which nm-connection-editor

# Check for nm-applet
which nm-applet

# Check if NetworkManager service is running
systemctl status NetworkManager

6. Tips and Best Practices

6.1 General Tips

Learn keyboard shortcuts: nmtui navigation is much faster with Tab, Esc, and arrow keys
Use the right tool for the job: Don't struggle with nmtui when you need advanced features
nm-applet is a launcher: Remember it doesn't configure, it just activates and launches editors
Always test connections: After configuration, test before assuming it works
Keep backups: Connection files in /etc/NetworkManager/system-connections/ should be backed up before major changes

6.2 nmtui Specific Tips

Tab is your friend: Tab through fields faster than arrow keys
Esc to back out: Esc key goes back/cancels at each menu level
Launch directly: Use nmtui edit or nmtui connect to skip main menu
Works in screen/tmux: Perfect for persistent SSH sessions

6.3 nm-connection-editor Tips

Read tooltips: Hover over options for helpful explanations
IPv4/IPv6 tabs: Settings separated by protocol, configure both if needed
Save vs Apply: "Save" commits changes to config, connection must be reactivated
Advanced button: Many dialogs have "Advanced" buttons with more options

6.4 nm-applet Tips

Right-click menu: More options available via right-click vs left-click
Connection Information: Shows current IP, DNS, routes - useful for troubleshooting
Enable/Disable networking: Quick way to test if network issues are configuration-related
Hidden networks: Can connect to hidden WiFi networks via "Connect to Hidden Network"

7. Integration with nmcli

While this guide focuses on UI tools, it's important to understand how they relate to nmcli (the command-line interface):

All UI tools and nmcli work with the same connection profiles. A connection created in nmtui can be activated in nm-applet and modified in nm-connection-editor. They all read/write the same configuration files in /etc/NetworkManager/system-connections/.

When to Use nmcli Instead

Scripting: Automating network configuration
Remote administration: When even nmtui is too slow over high-latency connections
Advanced features on servers: Full feature access without GUI dependencies
Batch operations: Modifying multiple connections
Integration with other tools: Parsing output, monitoring

# Example: nmcli can do everything the UI tools can do
nmcli connection show
nmcli device status
nmcli connection up "MyConnection"
nmcli connection modify "MyConnection" ipv4.addresses 192.168.1.100/24

8. Troubleshooting

8.1 Common Issues

nmtui Not Available

Problem: nmtui: command not found
Solution: Install NetworkManager-tui package (may be separate from base NetworkManager)

nm-connection-editor Won't Launch

Problem: cannot open display or similar
Solution:

Ensure you're in a graphical desktop environment
Check DISPLAY variable is set: echo $DISPLAY
If over SSH, use ssh -X for X11 forwarding (not recommended)

nm-applet Not in System Tray

Problem: Applet icon not visible
Solution:

Check if running: ps aux | grep nm-applet
Start manually: nm-applet &
Add to startup applications in desktop environment settings
Some desktop environments (like GNOME 3+) integrate NetworkManager differently

Changes Not Taking Effect

Problem: Modified connection settings don't apply
Solution:

Deactivate and reactivate the connection
Use nmcli connection reload if manually edited files
Restart NetworkManager service: sudo systemctl restart NetworkManager

9. Quick Reference Summary

If You Need To...	Use This Tool
Configure network on headless server	`nmtui`
Configure network via SSH	`nmtui`
Set system hostname with UI	`nmtui hostname`
Basic Ethernet/WiFi setup	`nmtui` or `nm-connection-editor`
Configure VPN	`nm-connection-editor`
Configure 802.1X WiFi	`nm-connection-editor`
Advanced bonding/bridging	`nm-connection-editor`
Configure static routes	`nm-connection-editor`
Quick WiFi switching (daily use)	`nm-applet`
Monitor connection status	`nm-applet`
Quick VPN connect/disconnect	`nm-applet`
Scripting/automation	`nmcli` (not a UI tool)

10. Conclusion

NetworkManager's UI tools are designed to complement each other, each excelling in specific scenarios:

nmtui is your SSH and headless system friend
nm-connection-editor is your comprehensive configuration powerhouse
nm-applet is your daily-driver quick-access tool

Understanding when to use each tool will make network administration more efficient and less frustrating. Don't try to force a tool into a role it wasn't designed for - use the right tool for the job.

Pro Tip: Most experienced admins use a combination:

nmtui for initial server setup and SSH work
nm-connection-editor for complex configurations that require it
nm-applet for daily connection management on workstations
nmcli for scripting and automation

Document Information
Title: NetworkManager UI Tools - Comprehensive Comparison
Version: 1.0
Last Updated: October 2025
Created by: Claude (Anthropic AI Assistant)
Target Audience: Linux System Administrators

This document provides guidance on NetworkManager UI tools. Always consult official documentation and man pages for complete, system-specific information. Test configurations in non-production environments first.