GeeXboX Advanced Configuration – Network Configuration

September 8th, 2012 Leave a comment Go to comments


Editing Network Configuration …

GeeXboX comes with network support for most Ethernet and WiFi cards. By default, GeeXboX runs a DHCP client which is trying to autoconfigure your network adapter. If you do not have a DHCP server on your network, you’ll have to modify the /etc/network file by hand as to update the following lines:

# “LAN” or “WLAN” or “” (default is “” <–> “LAN”)

# Network interface name or address (e.g. “eth0” or “00:0d:56:ec:ba:0c”)

# Static IP address (“” for DHCP) in CIDR format (e.g. “”)

# Network gateway (e.g. “”)

# List of DNS servers (e.g. “;”)

On boot, the GeeXboX checks for remote computers from a common domain and tries to automatically discover and mount the Samba Windows shares. Be sure that all of your computers are on the same domain/subnet in order to mount all the shares.

WiFi Configuration …

By default, GeeXboX tries to autodetect your network settings. If you have both traditional NIC and WiFi cards, only the latter will be set up. Once again, you may have to modify the /etc/network file in order to fill in your network settings. In this case, 4 lines are related to wireless cards :

# WiFi Network SSID

# Hidden LAN ? “true” or “”

# “WEP” or “PSK” or “” or “RSN”

# WiFi WEP/WPA key

These lines let you configure most of the settings. You can enable auto-detection, or even force the use of ethernet or WiFi adapters.

In the same way, this lets you define your WEP key and WLAN SSID.

Network Services …

GeeXboX features a few network services that allow you to either connect to or be connected to different facilities.

Among them, one may find:

  • a Telnet server (default is enabled).
  • a FTP server (default is enabled).
  • a HTTP server (default is disabled).
  • a Samba server (default is disabled).
  • a ZeroConf service discovery agent (default is enabled).
Configuring the state of these services can be done by modifying the /etc/network file the following way:

# Services to be started at boot time

# Use Zeroconf service discovery

For advanced users only …

1) you have two backends to manage your network devices : connman and udhcpc. By default , we use connman but you can enable udhcpc

just change NETWORK_BACKEND=”connman” by NETWORK_BACKEND=”udhcpc”

2) If you use a wifi dongle, enable the setting :  WAIT_FOR_SLOW_DEVICE and change value to “true”


  1. johny
    January 17th, 2012 at 11:13 | #1

    Hello, sorry for my English :-). I have problem with samba server config. I don’t understand, where i must config samba server, because if I set SAMBA_SERVER=”yes” server is not runnig. Thank for your answer.

  2. schlappeseppel
    March 1st, 2012 at 03:16 | #2
  3. Jj
    March 8th, 2013 at 06:16 | #3

    do the geexbox supports wpa2-pks combination?? so far i could get that working in *buntu but not in geexbox…any help is appreciated.

  4. tomlohave
    March 11th, 2013 at 00:24 | #4

    yes, if it’s not the case, open a new topic

  5. Maarten
    March 30th, 2013 at 04:31 | #5

    I just wanted to mention that my Wifi setup went quick and smooth, despite various posts about Wifi issues.

    I spent some time in advance to find a compliant Wifi USB dongle. I choose the TP-Link TL-WN727N Wireless N USB Adapter (Ralink RT5370).

    Note that the following additional settings in /etc/network may be required for Wifi dongles:


  6. Ray Culp
    April 15th, 2014 at 18:54 | #6

    I tried an X-Micro and a Fritz! WLAN USB dongle, and the system doesn’t seem to recognize either of them.

    I googled “geexbox supported wlan adapters” but didn’t find any useful information. Is there a list of supported USB WLAN sticks somewhere? Or do I just have to find one that is “Linux-compatible”?

  7. thisismyname
    May 5th, 2014 at 21:16 | #7

    How to apply changes in /etc/network ?? sysctl restart networking??
    What about a file named /etc/network2 ??
    Which scripts are used to read this network configuration?

  1. No trackbacks yet.
You must be logged in to post a comment.