From Fedora Project Wiki

Adding NetworkManager Connections via CLI

Summary

Support for adding new NetworkManager connections using the nmcli commandline tool.

Owner

Current status

  • Targeted release: Fedora 20
  • Last updated: 2013-07-17
  • Tracker bug: <will be assigned by the Wrangler>

Detailed Description

Administrators will be able to configure new connections via a simple command-line interface. It will be possible to create and activate new connections, as well as delete them.

Benefit to Fedora

Users more comfortable with the command-line will now have a capable network configuration tool in addition to directly editing network configuration files. Adding and changing network connections is a common task and should be easy to do from the command-line, in addition to GUI tools like nm-connection-editor. These enhancements will add support for configuring all major network connection types supported by NetworkManager (including bridge, bond, vlan, wifi, ethernet, 3G/4G, etc) from an interactive mode of nmcli.

Scope

Upgrade/compatibility impact

Some of the arguments to nmcli will change, which may impact scripts. Reasonable efforts to interpret the old option formats will be made.

How To Test

Create a connection using nmcli and check that it was successful.

User Experience

Users comfortable with the command-line can run nmcli in an interactive mode to create or edit network connections through an interface similar to mysql or fdisk.

Dependencies

None.

Contingency Plan

  • Contingency mechanism: Administrators can continue hand-editing configuration files in keyfile or ifcfg format.
  • Contingency deadline: N/A
  • Blocks release? N/A

Documentation

Documentation will be drafted at Networking/CLI.

Release Notes

NetworkManager's nmcli command-line tool now supports adding and editing network connections.