nmtui
nmtui는 NetworkManager connection을 terminal에서 편집하고 활성화하는 curses 기반 TUI client다.
Installation
sudo apt update sudo apt install network-manager # Debian, Ubuntu sudo dnf install NetworkManager NetworkManager-tui # Fedora, RHEL 계열 nmtui --help
NetworkManager는 Linux daemon이므로 macOS Homebrew와 Windows winget용 공식 package는 제공되지 않는다.
Usage
nmtui nmtui edit [NAME|ID] nmtui connect [NAME|UUID|DEVICE|SSID] nmtui hostname
nmtui edit [NAME|ID]: profile을 생성, 조회, 수정 또는 삭제한다.nmtui connect [NAME|UUID|DEVICE|SSID]: connection을 활성화하거나 비활성화한다.nmtui hostname: system hostname을 설정한다.
같은 동작으로 바로 진입하는 nmtui-edit, nmtui-connect, nmtui-hostname binary도 제공된다.
Examples
sudo nmtui edit sudo nmtui edit lan-static nmtui connect sudo nmtui hostname
- 방향키 또는 Tab으로 항목을 이동하고 Enter로 선택한다.
- Esc로 이전 화면으로 돌아간다.
- root 권한이 필요한 변경은 polkit agent가 없으면
sudo nmtui로 실행한다.
SSH connection에 사용 중인 profile을 수정하거나 비활성화하면 session이 끊길 수 있다. 저장 전에 IP, gateway와 interface를 다시 확인한다.
Help
Troubleshooting
- TUI가 깨져 보이면
TERM값과 terminal 크기를 확인한다. - 원하는 profile이 없으면
nmcli connection show로 실제 이름과 UUID를 확인한다. - 정밀한 property나 script 작업은 nmcli를 사용한다.
See Also
History
- codex:: 2026-07-19 nmtui activity, direct binary, terminal 조작과 안전 주의를 정리했다.