nmcli — NetworkManager CLI

If you like this project, consider supporting me on Buy Me a Coffee ☕️

nmcli — NetworkManager Command Line Interface

nmcli is the command-line interface for NetworkManager, the default network management tool for RHEL, Fedora, Ubuntu, and many other distributions. It provides full control over network connections without requiring a GUI.

Installation & Configuration

Install NetworkManager / Установка NetworkManager

Debian / Ubuntu

sudo apt update && sudo apt install -y network-manager  # Install NetworkManager / Установить NetworkManager

RHEL / CentOS / AlmaLinux

sudo dnf install -y NetworkManager  # Install NetworkManager / Установить NetworkManager

Enable NetworkManager Service / Включение сервиса

sudo systemctl enable --now NetworkManager  # Enable and start / Включить и запустить
sudo systemctl status NetworkManager          # Check status / Проверить статус

Configuration Paths / Пути конфигурации

• Main config: /etc/NetworkManager/NetworkManager.conf
• Connection profiles: /etc/NetworkManager/system-connections/
• Dispatcher scripts: /etc/NetworkManager/dispatcher.d/
• DNS config: /etc/NetworkManager/conf.d/

Log Locations / Расположение логов

• Journal: journalctl -u NetworkManager -f
• Legacy log: /var/log/syslog or /var/log/messages

Core Management / Основное управление

General Status / Общий статус

nmcli general status                  # Overall NM status / Общий статус NetworkManager
nmcli general hostname                # Show hostname / Показать имя хоста
sudo nmcli general hostname <HOST>    # Set hostname / Установить имя хоста

Sample Output:

STATE      CONNECTIVITY  WIFI-HW  WIFI     WWAN-HW  WWAN    
connected  full          enabled  enabled  enabled  enabled

Device Management / Управление устройствами

nmcli device status                   # List all devices / Список устройств
nmcli device show <DEVICE>            # Show device details / Детали устройства
nmcli device connect <DEVICE>         # Connect device / Подключить устройство
nmcli device disconnect <DEVICE>      # Disconnect device / Отключить устройство
nmcli device wifi list                # List WiFi networks / Список WiFi сетей

Connection Management / Управление соединениями

nmcli connection show                 # List all connections / Список соединений
nmcli connection show <CONN>          # Show connection details / Детали соединения
nmcli connection up <CONN>            # Activate connection / Активировать соединение
nmcli connection down <CONN>          # Deactivate connection / Деактивировать соединение
nmcli connection reload               # Reload all configs / Перезагрузить конфигурации
nmcli connection delete <CONN>        # Delete connection / Удалить соединение

[!TIP] Connection names with spaces must be quoted: nmcli connection up "My WiFi"

Connection Types / Типы соединений

Ethernet Static IP / Статический IP для Ethernet

nmcli connection add \
  type ethernet \
  con-name <CONN_NAME> \
  ifname <INTERFACE> \
  ip4 <IP>/24 \
  gw4 <GATEWAY> \
  ipv4.dns "<DNS1> <DNS2>"
# Create static Ethernet connection / Создать статическое Ethernet подключение

Example:

nmcli connection add \
  type ethernet \
  con-name office-eth \
  ifname enp0s3 \
  ip4 192.168.1.100/24 \
  gw4 192.168.1.1 \
  ipv4.dns "8.8.8.8 8.8.4.4"

Ethernet DHCP / DHCP для Ethernet

nmcli connection add \
  type ethernet \
  con-name <CONN_NAME> \
  ifname <INTERFACE>
# Create DHCP Ethernet connection / Создать DHCP Ethernet подключение

Modify Existing Connection / Изменить существующее соединение

nmcli connection modify <CONN> ipv4.addresses <IP>/24  # Change IP / Изменить IP
nmcli connection modify <CONN> ipv4.gateway <GATEWAY>  # Change gateway / Изменить шлюз
nmcli connection modify <CONN> ipv4.dns "<DNS1> <DNS2>"  # Change DNS / Изменить DNS
nmcli connection modify <CONN> ipv4.method manual      # Set to static / Переключить на статику
nmcli connection modify <CONN> ipv4.method auto        # Set to DHCP / Переключить на DHCP
nmcli connection up <CONN>                              # Apply changes / Применить изменения

[!WARNING] Always run nmcli connection up <CONN> after modifying to apply changes. Without this, the configuration is saved but not active.

WiFi Management / Управление WiFi

List Available Networks / Список доступных сетей

nmcli device wifi list                # Show all WiFi networks / Показать WiFi сети
nmcli device wifi rescan              # Rescan for networks / Повторить сканирование

Connect to WiFi / Подключиться к WiFi

nmcli device wifi connect "<SSID>" password "<PASSWORD>"  # Connect to WiFi / Подключиться к WiFi

Create WiFi Connection / Создать WiFi соединение

nmcli connection add \
  type wifi \
  con-name <CONN_NAME> \
  ifname <INTERFACE> \
  ssid "<SSID>" \
  wifi-sec.key-mgmt wpa-psk \
  wifi-sec.psk "<PASSWORD>"
# Create WiFi connection / Создать WiFi подключение

WiFi Hotspot / WiFi точка доступа

nmcli device wifi hotspot \
  ifname <INTERFACE> \
  ssid "<HOTSPOT_NAME>" \
  password "<PASSWORD>"
# Create WiFi hotspot / Создать WiFi точку доступа

VPN Connections / VPN соединения

OpenVPN Connection / OpenVPN подключение

nmcli connection import type openvpn file <CONFIG>.ovpn  # Import OpenVPN config / Импортировать OpenVPN
nmcli connection up <VPN_NAME>                            # Connect to VPN / Подключиться к VPN

Manual VPN Setup / Ручная настройка VPN

nmcli connection add \
  type vpn \
  vpn-type openvpn \
  con-name <VPN_NAME> \
  vpn.data "remote=<VPN_SERVER>, connection-type=password"
# Create VPN connection / Создать VPN подключение

Advanced Networking / Продвинутые настройки

Bridge Creation / Создание моста

nmcli connection add type bridge con-name <BRIDGE_NAME> ifname <BRIDGE_IF>  # Create bridge / Создать мост
nmcli connection add type ethernet slave-type bridge con-name <SLAVE_NAME> ifname <INTERFACE> master <BRIDGE_IF>  # Add slave / Добавить slave
nmcli connection up <BRIDGE_NAME>  # Activate bridge / Активировать мост

Bond (Link Aggregation) / Объединение каналов

nmcli connection add type bond con-name <BOND_NAME> ifname <BOND_IF> mode active-backup  # Create bond / Создать bond
nmcli connection add type ethernet slave-type bond con-name <SLAVE1> ifname <IF1> master <BOND_IF>  # Add first slave / Первый интерфейс
nmcli connection add type ethernet slave-type bond con-name <SLAVE2> ifname <IF2> master <BOND_IF>  # Add second slave / Второй интерфейс
nmcli connection up <BOND_NAME>  # Activate bond / Активировать bond

VLAN Configuration / Настройка VLAN

nmcli connection add type vlan con-name <VLAN_NAME> dev <PARENT_IF> id <VLAN_ID>  # Create VLAN / Создать VLAN
nmcli connection modify <VLAN_NAME> ipv4.addresses <IP>/24  # Set IP / Установить IP
nmcli connection up <VLAN_NAME>  # Activate VLAN / Активировать VLAN

Troubleshooting & Tools / Устранение неполадок

Common Issues / Типичные проблемы

# Connection won't activate / Соединение не активируется
nmcli connection delete <CONN> && nmcli connection reload  # Delete and reload / Удалить и перезагрузить

# DNS not resolving / DNS не работает
nmcli connection modify <CONN> ipv4.ignore-auto-dns yes  # Ignore auto DNS / Игнорировать авто DNS
nmcli connection modify <CONN> ipv4.dns "8.8.8.8 8.8.4.4"  # Set manual DNS / Установить DNS вручную
nmcli connection up <CONN>  # Apply / Применить

# NetworkManager not managing interface / NetworkManager не управляет интерфейсом
sudo nmcli device set <DEVICE> managed yes  # Enable management / Включить управление

Debug Logging / Отладочное логирование

sudo nmcli general logging level DEBUG  # Enable debug logging / Включить отладку
journalctl -u NetworkManager -f          # Watch logs / Смотреть логи
sudo nmcli general logging level INFO    # Restore normal logging / Восстановить обычное логирование

Export/Import Connections / Экспорт/Импорт соединений

nmcli connection show <CONN> > <CONN>.txt  # Export connection details / Экспортировать детали
sudo cp /etc/NetworkManager/system-connections/<CONN> /backup/  # Backup connection file / Бэкап файла

Comparison Tables / Таблицы сравнения

Bond Modes Comparison / Сравнение режимов Bond

Connection Types Comparison / Сравнение типов соединений