GeeXboX Advanced Configuration – Network Configuration


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”


7 thoughts on “GeeXboX Advanced Configuration – Network Configuration”

  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. 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:


  3. 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”?

  4. 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?

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.