How to configure an IP address on Raspberry Pi

The default Raspbian system for Raspberry Pi is set up to get an IP address automatically from the network via DHCP, whether for wired Ethernet or wireless WiFi (via a USB wireless dongle). Raspbian can support both IPv4 and IPv6. IPv4 is ready for use by default, while IPv6 must be enabled manually.

If you want to set up an IP address for wired or wireless networks on a Raspbian system, there are several ways to do it, either in the text (manual) mode or via GUI tools.

In this tutorial, I will explain several ways to configure an IP address on Raspbian-powered Raspberry Pi. IPv4 will be used in this tutorial.

Wifi-Config: Configure an Automatic DHCP Ip Address on WiFi Network

If you want to connect Raspberry Pi to a WiFi access point, you can use a USB wireless network dongle. If you plan to buy one, it is recommended to check which wireless chipset will work with Raspberry Pi before you buy. Otherwise, you may be frustrated trying to figure out how to install a necessary driver on Raspberry Pi. Refer to this page for a list of RPi-compatible USB Wi-Fi adapters.

To get an IP address for a USB WiFi dongle, follow the instructions below. Here I use Ralink USB WiFi dongle with RT5370 chipset. This chipset is recognized by Raspbian automatically.

After plugging in your USB WiFi dongle, power up Raspberry Pi.

Log in to Raspberry Pi, and launch GUI desktop by typing:

$ startx

Double-click on "WiFi Config" icon on the desktop.

This will give you a "wpa_gui" window (see picture below).

Click on "Scan" button to open the following scan result window.

Click on "Scan" button on this window to get a list of available WiFi access points.

Double-click on the SSID of the access point to connect to, and then type in access password (if required).

Click on "Add" button to permanently add the configured access point to "Manage Networks" tab.

When done, click on "Current Status" tab, and then click on "Connect" button to connect the access point. It will take a couple of seconds until you get an IP address from DHCP negotiation.

After you get an IP address, you can close the "wpa_gui" window. You can still check the current status of wireless connection from desktop tray icon as shown below.

Text Mode: Configure a Static IP Address for Wired Ethernet

To configure Raspbian with a static IP address manually for the Ethernet, follow the instructions below.

Make sure that you plug in everything right (keyboard, HDMI monitor/TV, SD card, power cable adapter), and then turn on the power.

Wait until you are prompted to log in, and type "pi" for username and "raspberry" for password (which are default Raspbian login credentials).

A Raspbian's network configuration file is located at /etc/network/interfaces. A default configuration looks like the following, where DHCP is used for wired Ethernet.

auto lo
iface lo inet loopback
iface eth0 inet dhcp
allow-hotplug wlan0
iface wlan0 inet manual
wpa-roam /etc/wpa_supplicant/wpa_supplicant.conf
iface default inet dhcp

Edit this config file with any text editor as follows. The bold font texts are newly updated configuration.

$ sudo nano /etc/network/interfaces
auto lo
iface lo inet loopback
# iface eth0 inet dhcp
auto eth0
iface eth0 inet static
address 192.168.2.6
netmask 255.255.255.0
gateway 192.168.2.1
allow-hotplug wlan0
iface wlan0 inet manual
wpa-roam /etc/wpa_supplicant/wpa_supplicant.conf
iface default inet dhcp

In the updated config file, the line containing "dhcp" is commented out, and static IP configuration (with IP address, netmask and gateway) is added. Adjust the settings according to your network condition.

Restart the networking services to activate the change without reboot.

$ sudo service networking restart

To check whether an IP address is set or not, type ip command.

Wicd Tool: Configure a Static IP Address for Wired Ethernet and WiFi

Another way to set up a static IP address on Raspberry Pi is using Wicd tool, which is an open-source network manager for wired and wireless networks. Wicd tool is not installed on Raspbian by default, so you need to install it first.

Follow instructions below to install Wicd and set up a static IP address with Wicd.

$ sudo apt-get update
$ sudo apt-get install wicd-curses

To launch Wicd, run:

$ sudo wicd-curses

You will see an ncurses-based interface for listing available wired and wireless networks.

The instruction for setting up a static IP address on Wicd is the same for both wired Ethernet or WiFi networks (accessible via a USB WiFi dongle).

First, you need to highlight a network to configure (e.g., a Ethernet-based wired network, or a particular WiFi access point), and press right arrow button. This will open a setup window (see picture below).

Press space button to turn on "Use Static IPs", and then fill out IP address, netmask and gateway.

In case of WiFi configuration, besides above information, you will also need to fill out an access point password in the "Key" field.

Press F10 button to save the entered information, which will then bring you back to the list of available networks.

Note: Wicd is also available as a full GUI version (i.e., wicd-gtk). This version comes with wicd-tray, which will be automatically loaded when you log in to your desktop, as configured in /etc/xdg/autostart/wicd-tray.desktop. To install wicd-gtk, simply run:

$ sudo apt-get install wicd-gtk

Here are screenshots of wicd-gtk and its desktop tray icon.

Subscribe to Xmodulo

Do you want to receive Linux FAQs, detailed tutorials and tips published at Xmodulo? Enter your email address below, and we will deliver our Linux posts straight to your email box, for free. Delivery powered by Google Feedburner.

The following two tabs change content below.
Kristophorus Hadiono is a Linux enthusiast and a teacher in private higher educations in Indonesia. He uses Linux for his daily computing, also when he teaches his students. He is currently continuing his education with government scholarship at a private university in Bangkok, Thailand.
Your name can also be listed here. Write for us as a freelancer.

14 thoughts on “How to configure an IP address on Raspberry Pi

  1. You realize you can set static IP using GUI? and how about configuring wpa_supplicant from the command line? why bother starting X server? What's the point of starting X server if that all can be configured from command line, easier and faster?

    • Of course you can do pretty much everything in Linux from the command line, but this is not commandlinefu.com so why bother?

    • I just want to show how to configure a static IP address without using text editor, especially for people who do not have Linux experience, but jump straight to the raspberry pi with raspbian image.

  2. startx? Double click? Are we talking about that handy little embedded-like system with GPIO pins in its natural use, or about installing and setting up Raspbian with GUI and misusing the Raspberry Pi as desktop system?

  3. Can someone please confirm if I got this right: to establish a static IP address for an Rpi on a wireless network, you either use a tool like wicd-curses as described above; or if you have access permission to the router you can reserve a static address there. Thanks :)

    • @Peter: both of them will works, depends on your situations I think. If you can access the router to reserve static address for RPi then it would be better for your RPI, you don't need to set something with your RPi network configurations. But, if you doesn't want to mess up your hand with editing the network configuration files, wicd-curses is better... :)

  4. If I install the full GUI version of Wicd, do I need to un-install anything or change anything with:
    $ sudo nano /etc/network/interfaces ??
    or, will Wicd take care of changing whatever needs to be changed? Also, does the DNS need to change when I switch from DHCP to a static IP address? And, if it needs to change, does the GUI version of Wicd have a place to change the DNS to something like 8.8.8.8 8.8.4.4 ?? or whatever it should be?

  5. It is better to set up static IP from router to avoid IP conflict situations when for example you start rpi after another device that router has already allocated the IP that you setup for rpi.

  6. Am I the only one having trouble being able to plug enough stuff in to actually configure the wifi? If I plug in the wifi dongle and the keyboard, I don't have a free USB slot for the mouse, so trying to use the GUI is a wash. If I plug in keyboard and mouse, there's no room for the wifi dongle and I have nothing to configure!

Leave a comment

Your email address will not be published. Required fields are marked *

Current ye@r *