This wiki will shut down!
Please note that this wiki will be made read-only and eventually be taken offline.
A replacement is being discussed at https://github.com/awesomeWM/awesome-www/issues/7. We'd be happy to have more input for that discussion and volunteers who help us migrate the content of this wiki to its replacement.
English • русский
nm-applet is a system tray application to help connect to both wired and wireless networks.
Running as a non-root user: easy way
Add yourself to netdev group:
adduser username netdev
usermod username -aG netdev
Run nm-applet on startup by adding the following at the end of your rc.lua:
A better way to autostart programs is start them if they're not already running.
Restart awesome and try connecting to a network. If this fails, follow the non-easy way below.
Running as a non-root user
If one tries to run nm-applet as a non-root user then it will often show no networks, this is because of its security policies. It is possible to run it using "sudo nm-applet", however this will not allow you to autostart it.
To allow the user to run nm-applet on without root privileges the following files need to be edited:
In each file, copy the section of text which starts with <policy user="root"> and ends with </policy>. Paste it immediately below the </policy> line, and change the <policy user="root"> line to your username, i.e. <policy user="fred">, where "fred" is your username.
<policy user="root"> <allow own="org.freedesktop.nm_dhcp_client"/> <allow send_interface="org.freedesktop.nm_dhcp_client"/> </policy>
<policy user="root"> <allow own="org.freedesktop.nm_dhcp_client"/> <allow send_interface="org.freedesktop.nm_dhcp_client"/> </policy> <policy user="fred"> <allow own="org.freedesktop.nm_dhcp_client"/> <allow send_interface="org.freedesktop.nm_dhcp_client"/> </policy>
After this, nm-applet should work when started normally.
Fix error creating/editing new networks due to insufficient provileges
If you cannot create new networks or edit existing ones because of the error "Failed to add new connection: (32) Insufficient privileges", then check this solution.
To autostart nm-applet first add the above changes to the configuration, then add:
To the end of your rc.lua file.
nm-applet >= 0.9.4.1-1
The new version of nm-applet requires polkit to be running in background in order to correctly work. add your username to the netdev group
Create a small run_once script as described in the Autostart page (eg: /usr/local/bin/run_once)
#!/bin/bash #Alternative pgrep $@ > /dev/null || ($@ &)
at the end of the rc.lua add start the gnome polkit daemon and the applet
awful.util.spawn_with_shell("/usr/lib/policykit-1-gnome/polkit-gnome-authentication-agent-1") awful.util.spawn_with_shell("run_once nm-applet")
- The run_once script avoid nm-applet to start twice in case of multi-screen configuration.
The network icon is a bit too large to fit in the status bar if it uses the default 8pt font size. Changing the font size to 10pt for example fixes this issue. This is a bug in network-manager, see https://awesome.naquadah.org/bugs/index.php?do=details&task_id=1143&project=1&pagenum=3 for more information.
Alternative to nm-applet
wicd (wicd.sourceforge.net) is an alternative to the gnome network manager and it only gtk dependent. wicd as 3 client front-ends:
- wicd-cli: a scriptable console client
- wicd-curses: a Curse client
- wicd-gtk: a gtk client interface and systray applet.