From Fedora Project Wiki

Integrate Proxy Settings with NetworkManager


Currently Proxy Settings are handled separately (by gnome-control-center in gnome) from NetworkManager. However, since proxy settings are connection dependent, they have to be updated as connections get (de-)activated. NetworkManager which handles that is the perfect place to do it.

Needs Addressed

It makes proxy setting configuration and its propagation to all desktop and console processes automated on a per-connection basis instead of the user setting them each time manually on connection changes.

Relevant Experience: I understand the D-BUS architecture and NetworkManager's code base. I have also thoroughly investigated how applications (of gnome, kde and terminal) seek proxy information as a first step. That said, I understand the concepts of networking and can effortlessly read and write programs in C\C++\bash.


An NMProxyManager Gobject derivative class will be added to NetworkManager and initialized during start. This new module will expose the proxy settings over DBUS and call relevant executables to set the proxy settings, as connections get activated\deactivated. For settings, an NMSettingProxy subclass of NMSetting has to be implemented.


  • Find proxy setting propagation sources DONE!
  • Get NetworkManager & build on Fedora DONE!
  • Understand NetworkManager codebase DONE!
  • Implement NMSettingProxy DOING!
  • Implement NMProxyManager and its DBUS Interfaces
  • Write dispatcher scripts (using gsettings, kwriteconfig, profile.d scripts)
  • Make them build-configurable (update Makefiles)
  • Test it on gnome, kde and console applications
  • Send a pull request

Current Progress

This section will be changing continuously.

Proxy Setting Propagation sources

Gnome Applications

Gnome applications use values in org.gnome.system.proxy from gsettings.
gnome-terminal goes further by setting the $PROTOCOL_PROXY variables using them for the child process.

gsettings list-recursively  org.gnome.system.proxy

org.gnome.system.proxy autoconfig-url ''
org.gnome.system.proxy ignore-hosts ['localhost', '']
org.gnome.system.proxy mode 'manual'
org.gnome.system.proxy use-same-proxy false
org.gnome.system.proxy.ftp host ''
org.gnome.system.proxy.ftp port 8080
org.gnome.system.proxy.http authentication-password ''
org.gnome.system.proxy.http authentication-user ''
org.gnome.system.proxy.http enabled false
org.gnome.system.proxy.http host ''
org.gnome.system.proxy.http port 8080
org.gnome.system.proxy.http use-authentication false
org.gnome.system.proxy.https host ''
org.gnome.system.proxy.https port 8080
org.gnome.system.proxy.socks host ''
org.gnome.system.proxy.socks port 0

KDE Applications

KDE applications use kioslaverc data configured using kwriteconf.

[Proxy Settings]
Proxy Config Script=
ReversedException=false 8080 8080 8080 8080

Console Applications

$PROTOCOL_PROXY variables are sourced from /etc/profile.d/ scripts.
These following variables have to be set for console applications to work properly.

all_proxy http_proxy https_proxy ftp_proxy socks_proxy no_proxy

Building NetworkManager on Fedora

NetworkManager depends on many libraries including libgudev, libnl3, libuuid, nss and ppp. They are force-required in the makefiles, though you can edit it to leave some features not built. They are not so easy to figure out, but once done, it is very easy, since fedora's rpms maintain the correct version anyway.

Run this to get everything at once including gettext, intltool and libtool.

yum install gettext-devel gtk-doc intltool libtool dbus-glib-devel libgudev1-devel libnl3-devel libuuid-devel nss-devel ppp-devel

Now get NetworkManager and build it.

git clone git://
cd NetworkManager
./ --prefix=/usr --sysconfdir=/etc --localstatedir=/var
sudo make install 

To avoid over-writing and polluting the system, one could first uninstall NetworkManager without removing dependencies. It could be tricky to make an rpm out of it. But you can get a SPEC file here:

Now on fedora, NetworkManager by default uses the ifcfg-rh plugin to read\write settings from /etc/sysconfig/network-scripts/. We don't want that since it doesn't support proxy configuration. So we will switch to the generic keyfile plugin. The settings are then stored in /etc/NetworkManager/system-connections/ in the default ini like style (We will add proxy settings here). Edit /etc/NetworkManager/NetworkManager.conf to do this:


Adding NMSettingProxy

Currently working.