origin: https://wiki.debian.org/NetworkManager

Contents

1. NetworkManager
   1. Features
   2. Documentation
   3. Wired Networks are Unmanaged
   4. Enabling Interface Management
   5. "Auto Ethernet" and "Auto eth0"
   6. FAQ
   7. See Also
   8. External Links

---

NetworkManager

NetworkManager attempts to keep an active network connection available at all times.

The point of NetworkManager is to make networking configuration and setup as painless and automatic as possible. If using DHCP, NetworkManager isintended to replace default routes, obtain IP addresses from a DHCP server and change nameservers whenever it sees fit. In effect, the goal of NetworkManager is to make networkingJust Work.

If you have special needs, the upstream's developers would like to hear about them, but understand that NetworkManager is not intended to serve the needs of all users.

---

NetworkManager is composed of two parts:

1. A daemon running as root (network-manager).

2. A front-end (network-manager-gnome,plasma-nm).

NetworkManager will only handle interfaces not declared in /etc/network/interfaces (see README file).

Features

The features of NetworkManager are described on its homepage.

Documentation

Make sure you read the fine manual:

• /usr/share/doc/network-manager/README and/usr/share/doc/network-manager/README.Debian

• interfaces(5) man page

Wired Networks are Unmanaged

As of Debian 6.0 "Squeeze", NetworkManager does not manage any interface defined in/etc/network/interfaces by default.

Unmanaged devices means NetworkManager doesn't handle those network devices. This occurs when two conditions are met:

1. The file /etc/network/interfaces contains anything about the interface, even:

   allow-hotplug eth0iface eth0 inet dhcp

2. And /etc/NetworkManager/NetworkManager.conf contains:

   [main]plugins=ifupdown,keyfile[ifupdown]managed=false

Enabling Interface Management

If you want NetworkManager to handle interfaces that are enabled in/etc/network/interfaces:

• Set managed=true in /etc/NetworkManager/NetworkManager.conf.

• Restart NetworkManager:

  /etc/init.d/network-manager restart

"Auto Ethernet" and "Auto eth0"

• Auto Ethernet means "Select an Ethernet interface automatically"

• Auto eth0 means "autoconfigure the eth0 interface".

FAQ

Q. How do I configure a static IP address (for a server, etc) ?

A) Use nm-connection-editor or configure /etc/network/interfaces as described inNetworkConfiguration.

Q. How can I configure DNS for NetworkManager?

A) The short answer is to use nm-connection-editor. For the long answer see the corresponding entry inNetworkConfiguration.

Q. Why can't I see NetworkManager with my new user account ?

A) Make sure human users are in the netdev group (see/usr/share/doc/network-manager-gnome/README.Debian).

See Also

• PPP

• WiFi/HowToUse

External Links

• http://projects.gnome.org/NetworkManager/users/ - Project homepage and GNOME front-end (with some documentation);

  • http://live.gnome.org/NetworkManager - Various resources (FAQ, mailing list...)

• http://old-en.opensuse.org/Projects/KNetworkManager - KDE front-end

• nmcli(1) - Command-line client