Networkmanager nmcli

From wikinotes
Revision as of 14:15, 3 September 2022 by Will (talk | contribs) (→‎Basics)

Manages several network types.
You may also be interested in netctl.

Documentation

homepage https://wiki.gnome.org/Projects/NetworkManager
official docs https://developer.gnome.org/NetworkManager/stable/

Install

sudo pacman -S networkmanager

sudo systemctl enable NetworkManager.service
sudo systemctl start NetworkManager.service

Basics

# general commands
nmcli g[eneral]     # status, reload configuration, loglevel
nmcli r[adio]       # enable/disable/status radio connections (wifi, wwan)
nmcli n[etworking]  # enable/disable/status all networking

# common commands
nmcli d[evice]     # network interfaces
nmcli c[onnection] # network connections

# uncommon commands
nmcli a[gent]       # nmcli as polkit/secret agent
nmcli m[onitor]     # observe changes in connectivity, profiles

cookbook

nmcli n off                         # disable all networking
nmcli all off                       # disable all radio
nmcli d show                       # detailed info about devices
nmcli c[onnection] edit ${NAME}    # configure connection
nmcli c[onnection] up/down ${NAME} # set connection up/down

Network Types

Wired

Wired connections are automatically detected and configured as DHCP.
Alternatively, you can adjust them as you'd like.

# create a connection-profile on 'em0' with static-ip
nmcli con[nection] add \
  con-name home-network    `# name connection` \
  ifname em0 \
  type ethernet \
  ip4 192.168.100.100/24   `# static-ip` \
  gw4 192.168.100.1        `# gateway`

Wireless

# list network APs (SSIDs)
nmcli device wifi list

# configure wireless connection
nmcli device wifi \
  connect ${SSID} \
  password ${PASSWORD} \
  hidden yes  `# only if SSID is hidden`

# disable wifi
nmcli radio wifi off

Bluetooth

todo

Bridge

todo

Modem

todo

Configuring Connections

nmcli con[nection]                                 # list all connections
nmcli con[nection] edit ${NAME}                    # connection editor interpreter
nmcli con[nection] mod ${NAME} ${OPTION} ${VALUE}  # edit on cli
print  # show all options

DNS

nmcli con mod <connectionName> ipv4.dns "208.67.222.222 208.67.220.220"  # set DNS addresses
nmcli con mod <connectionName> ipv4.ignore-auto-dns yes                  # ignore DHCP provided nameservers