From Fedora Project Wiki
No edit summary
No edit summary
Line 1: Line 1:
==Description==
==Description==
nmcli is a tool that allows NetworkManager management from command line. This tool is useful in those cases in which a graphical frontend is not available.
nmcli is a tool that allows NetworkManager management from command line.


==Connect/disconnect to an already configured connection==
==NetworkManager status==
List already configured connections
 
<pre>nmcli con list</pre>
Display overall status of NetworkManager
<pre>nmcli general status</pre>
 
Display active connections
<pre>nmcli connection show active</pre>


Connect to a configured connection by name or uuid
Display all configured connections
<pre>nmcli con up id <connection name></pre>
<pre>nmcli connection show configured</pre>
<pre>nmcli con up uuid <uuid></pre>


Disconnection by name or uuid
==Connect/disconnect to an already configured connection==
<pre>nmcli con down id <connection name></pre>
<pre>nmcli con down uuid <uuid></pre>


==Network interfaces==
Connect to a configured connection by name
List available devices and their status
<pre>nmcli connection up id <connection name></pre>
<pre>nmcli dev status</pre>


Disconnect an interface
Disconnection by name
<pre>nmcli dev disconnect iface <interface></pre>
<pre>nmcli connection down id <connection name></pre>


==Wifi==
==Wifi==
Get Wifi status
Get Wifi status
<pre>nmcli nm wifi</pre>
<pre>nmcli radio wifi</pre>


Turn wifi on or off
Turn wifi on or off
<pre>nmcli nm wifi <on|off></pre>
<pre>nmcli radio wifi <on|off></pre>


List available access points(AP) to connect to
List available access points(AP) to connect to
<pre>nmcli dev wifi list</pre>
<pre>nmcli device wifi list</pre>
 
Refresh previous list
<pre>nmcli device wifi rescan</pre>


Create a new connection to an open AP
Create a new connection to an open AP
<pre>nmcli dev wifi connect <SSID|BSSID></pre>
<pre>nmcli device wifi connect <SSID|BSSID></pre>


Create a new connection to a password protected AP
Create a new connection to a password protected AP
<pre>nmcli dev wifi connect <SSID|BSSID> password <password></pre>
<pre>nmcli device wifi connect <SSID|BSSID> password <password></pre>
 
==Network interfaces==
List available devices and their status
<pre>nmcli device status</pre>


==Modify an already configured connection==
Disconnect an interface
Open with a text editor the configuration file of the connection. The file is located in "/etc/sysconfig/network-scripts/" under the name of "ifcfg-<connection name>"
<pre>nmcli device disconnect iface <interface></pre>
 
==Create or modify a connection==
 
To create a new connection using an interactive editor
<pre>nmcli connection edit con-name <name of new connection></pre>
 
To edit an already existing connection using an interactive editor
<pre>nmcli connection edit <connection name></pre>
 
To manually edit a connection configuration open or create with a text editor the configuration file of the connection located in "/etc/sysconfig/network-scripts/ifcfg-<connection name>"
 
==For versions previous to NetworkManager 0.9.9.0==
These versions lack some features described in this page and some of the commands may vary. If your current version is lower than 0.9.9.0 update NetworkManager. If you decide not to do so check the info pages for more information about your current version.
<pre>info nmcli</pre>
 
However as those previous version lack the support for connection editing, this have to be done manually. Open with a text editor the configuration file of the connection. The file is located in "/etc/sysconfig/network-scripts/" under the name of "ifcfg-<connection name>"


===Connect automatically to that connection===
===Connect automatically to that connection===
Line 52: Line 75:
Edit or add the line "MACADDR=<spoofed MAC>". Don't change the line "HWADDR=<real MAC>" to spoof your MAC address.
Edit or add the line "MACADDR=<spoofed MAC>". Don't change the line "HWADDR=<real MAC>" to spoof your MAC address.


===Edit a connection password===


Finally save the file and to apply changes to an already active connection execute
To modify a connection password open with a text editor and edit the file "keys-<connection id>" located in "/etc/sysconfig/network-scripts/". The password is stored in plain text
<pre>nmcli con up id <connection name></pre>


===Edit a connection password===
===Apply changes===
 
Finally save the files and to apply changes to an already active connection execute
<pre>nmcli connection up id <connection name></pre>


To modify a connection password open with a text editor and edit the file "keys-<connection id>" located in "/etc/sysconfig/network-scripts/". The password is stored in plain text
==Delete a connection configuration==
In case that the connection is active
<pre>nmcli connection down id <connection name></pre>


===Delete a connection===
Delete the connection
<pre>nmcli con delete id <connection name></pre>
<pre>nmcli connection delete id <connection name></pre>


==Notes==
==Notes==
Line 67: Line 95:
nmcli maybe contain some bugs and lack some features graphical tools for NetworkManager have.
nmcli maybe contain some bugs and lack some features graphical tools for NetworkManager have.


To see available options for nmcli deeper
To see all available options for your version of nmcli
<pre>man nmcli</pre>
<pre>info nmcli</pre>

Revision as of 13:14, 18 December 2013

Description

nmcli is a tool that allows NetworkManager management from command line.

NetworkManager status

Display overall status of NetworkManager

nmcli general status

Display active connections

nmcli connection show active

Display all configured connections

nmcli connection show configured

Connect/disconnect to an already configured connection

Connect to a configured connection by name

nmcli connection up id <connection name>

Disconnection by name

nmcli connection down id <connection name>

Wifi

Get Wifi status

nmcli radio wifi

Turn wifi on or off

nmcli radio wifi <on|off>

List available access points(AP) to connect to

nmcli device wifi list

Refresh previous list

nmcli device wifi rescan

Create a new connection to an open AP

nmcli device wifi connect <SSID|BSSID>

Create a new connection to a password protected AP

nmcli device wifi connect <SSID|BSSID> password <password>

Network interfaces

List available devices and their status

nmcli device status

Disconnect an interface

nmcli device disconnect iface <interface>

Create or modify a connection

To create a new connection using an interactive editor

nmcli connection edit con-name <name of new connection>

To edit an already existing connection using an interactive editor

nmcli connection edit <connection name>

To manually edit a connection configuration open or create with a text editor the configuration file of the connection located in "/etc/sysconfig/network-scripts/ifcfg-<connection name>"

For versions previous to NetworkManager 0.9.9.0

These versions lack some features described in this page and some of the commands may vary. If your current version is lower than 0.9.9.0 update NetworkManager. If you decide not to do so check the info pages for more information about your current version.

info nmcli

However as those previous version lack the support for connection editing, this have to be done manually. Open with a text editor the configuration file of the connection. The file is located in "/etc/sysconfig/network-scripts/" under the name of "ifcfg-<connection name>"

Connect automatically to that connection

Edit to or add the line "ONBOOT=yes"

Make the connection available only to one user

Edit or add the line "USERS=<username>"

Spoof MAC address

Edit or add the line "MACADDR=<spoofed MAC>". Don't change the line "HWADDR=<real MAC>" to spoof your MAC address.

Edit a connection password

To modify a connection password open with a text editor and edit the file "keys-<connection id>" located in "/etc/sysconfig/network-scripts/". The password is stored in plain text

Apply changes

Finally save the files and to apply changes to an already active connection execute

nmcli connection up id <connection name>

Delete a connection configuration

In case that the connection is active

nmcli connection down id <connection name>

Delete the connection

nmcli connection delete id <connection name>

Notes

nmcli maybe contain some bugs and lack some features graphical tools for NetworkManager have.

To see all available options for your version of nmcli

info nmcli