From Fedora Project Wiki

< Tools

Revision as of 00:37, 27 July 2012 by Pavlix (talk | contribs) (Known problems)


NetworkManager is the primary configuration service for networking.

It provides automatic network detection and configuration for the system. Once enabled, the NetworkManager service also monitors the network interfaces, and may automatically switch to the best connection at any given time. Applications that include NetworkManager support may automatically switch between on-line and off-line modes when the system gains or loses network connectivity.

These facilities are most useful for modern laptops, where the user may move between wireless networks, and plug in to a variety of wired networks, but NetworkManager also provides features that are relevant to workstations. Current versions of NetworkManager support modem connections, and certain types of VPN. Development of these features is ongoing.

NetworkManager requires Fedora to have drivers for the wired and wireless interfaces on the computer. Many manufacturers of modems and wireless devices provide limited support for Linux. You may need to install additional drivers or firmware on your Fedora system in order to activate these interfaces.

Drivers first
NetworkManager may only work with network interfaces once the relevant drivers are correctly installed on your system. Reboot your system after installing a new firmware or a new driver in order to ensure that the changes take effect.


NetworkManager objectives

NM is slowly changing from a desktop network connection configurator to a universal network configuration software that could be used as a part of the base system.

  • Provide core network configuration features
  • Expose the features through on-disk text-based configuration
  • Expose the features through D-Bus API
  • Provide basic CLI and GUI (other CLI/GUI frontends can be built on top of NetworkManager)


Broken features

Possible future features

  • Ethernet Bridging
  • Keeping wired devices allways on (for IPv6 link-local networking)
  • Support for IPv6 automatic reconfiguration (changing default routes, etc...)
  • Event-based IPv6 handling without timers and duplicate processing (would clean logs and make code more robust)
  • Exporting list of DNS servers and handing it over to recursive DNS servers like unbound and dnsmasq (especially necessary for proper VPN access)
  • Local caching nameserver with DNSSEC and forwarders
  • Support for networking on manually created interfaces (e.g. bridges)
  • Support for easy temporary connection setup through CLI, D-Bus (and GUI)
  • Support for making (the above) temporary connections permanent
  • It should be possible to configure NetworkManager not to manage any devices by default (each device managed only by explicit configuration), cmdline switch might be handy
  • NetworkManager should probably log external IPv4/IPv6 address/routing changes, as well as bridge configuration changes
  • NetworkManager should have an option to clean up any stuff created by itself (bridge/bond devices, addresses, etc)

Note: Some of the features described here may have been already available and working at some point of time.

More resources:

Known problems

Note: some of the problems are deep in the core of NetworkManager. It can be expected that more problems will emerge over time or while fixing the currently known ones.

Unreproduced problems

  • List of unmanaged devices (by MAC) is sometimes ignored
  • Manually assigned IPv4 addresses get lost (in tens of seconds)

Steps to 100% reproduce this are unknown, any help appreciated.


  • NetworkManager builds against specific distributions, not tools or dependencies (--with-distro)

About this section of the wiki

Currently most of the information in this page and the Tools/NetworkManager subtree have been added by me (User:Pavlix). Please feel free to add, correct and clarify stuff but please get in touch with me before deleting.

Further Information