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

Fedora is moving towards using NetworkManager as the main network configuration software. Adding new network connections is a common task and thus should be supported on the command line, in addition to GUI clients like nm-connection-editor. There will be two modes for connection addition: interactive - suitable for running in scripts, non-interactive guided mode targeted for manual editing.

Scope

  • Proposal owners: NetworkManager's nmcli tool.
  • Other developers: N/A
  • Release engineering: N/A
  • Policies and guidelines: N/A

Upgrade/compatibility impact

N/A

How To Test

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

User Experience

Administrators will be able to configure new connections via a simple command-line interface.

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 now supports adding new connections via CLI.