Join Amazon Student FREE Two-Day Shipping for College Students!

How to install OpenWrt on Raspberry Pi

How to install OpenWrt on Raspberry Pi

OpenWrt official supported Raspberry Pi. The latest OpenWrt release as of today already support for Raspberry Pi A, Raspberry Pi B, Raspberry Pi B+, and Raspberry Pi models.
The Raspberry Pi is supported in the brcm2708 target.


  • Raspberry Pi (Click here to buy from Amazon)
  • Power adapter (A popular power supply is the Apple 12W iPad charger, supplying 5V 2.4A. Similar high-powered mobile phone and tablet chargers should suffice. Using cheap power supplies off eBay is not recommended, as they provide a very uneven and noisy current which can lead to unreliable operation.)
  • SD Card (Regular SD or Micro SD based on the Raspberry Pi model you get)
  • PI Case
  • USB Ethernet adapter or WiFi dongle
  • Ethernet cable
  • HDMI monitor - setup only
  • USB Keyboard - setup only
  • Computer for SD Card image creation and configuration - setup only

Step 1: Download the relevant openwrt-brcm2708-bcm2708-sdcard-vfat-ext4.img (For Raspberry Pi A/B/B+) or openwrt-brcm2708-bcm2709-sdcard-vfat-ext4.img image (For Raspberry Pi 2).

Open and choose the most recent update from the download list.


Step 2: Flash OpenWrt to an SD/Micro SD card.

For Linux desktop:

1. Insert your SD/Micro SD card and run:


The most recent message should give you the SD card's device name, such as sdb or sdf or similar

2. As the root user, use dd to copy the image file to the device you identified previously, for example:

For Raspberry Pi A/B/B+:

dd if=/home/username/Downloads/openwrt-brcm2708-bcm2708-sdcard-vfat-ext4.img of=/dev/sdX bs=2M conv=fsync

For Raspberry Pi 2

dd if=/home/username/Downloads/openwrt-brcm2708-bcm2709-sdcard-vfat-ext4.img of=/dev/sdX bs=2M conv=fsync

Replace the sdX with your device name you already get from previous step, such as sdb or sdf.

For Windows desktop:

On a Windows desktop, use Win32DiskImager to copy the img file to your SD card's drive letter


At this point your are ready to boot OpenWrt on Raspberry Pi.

Step 3: Boot the Pi with OpenWrt

  • Insert the SD/Micro SD card into the Raspberry Pi
  • Attach HDMI to monitor
  • Attach keyboard
  • Plug in a network cable from your computer to the Raspberry Pi’s built in network port
  • Attach power

Once the console has stopped scrolling messages, press the enter key to open the command line prompt.

Run the following command:

ifconfig eth0

Pay attention to the inet addr line. You will need that address to login and manage the OpenWrt.


Open a web browser to the IP address you identified above and you will be able to configure your OpenWrt by using the interface now.


  1. Arun Khan says:

    I had been contemplating to use my RasPi as a WiFi as an AP and this post kind of nudged me into doing it -- thank you.
    I have a Raspi B (512M RAM with BCM2835 SoC) which takes the brcm2709 image.
    After dd'ing the image, I used 'gparted' to expand the ext4 file system to use the remainder of the 4GB SD card, which gives about 3.7GB of space to experiment with 🙂 Note: I did not change the location of the start of each partition.

    I was lazy and did not want to hook up a monitor, keyboard, and mouse so I took a chance on the image booting fine and it did! I was able to get *all* of the console work done via ssh sessions connected from my laptop. Note: First connection has to be via telnet to set the root password, after that telnet is disabled and only ssh connections are allowed.

    For the WiFi card, I am using an USB dongle which works fine on my laptop with the 'rtl8192cu' module but fails on the RasPi but that's a different story.

  2. Guido says:

    How can i compile a driver? I got the sourcecode but there is no compiler installed in the wrt image

  3. Mohamed says:
    for Marian

  4. Marian says:

    Thanks EX. I managed to install the driver, but something's off. While I can see the interface at the command line (using ssh) and I get a DHCP IP on that connection, on the "Interfaces" web gui, it shows me the same interface with no MAC address (shown as 00:00:00:00:00:00) and no IP address. Not sure what's the problem. I also noticed a strange behavior: every time I try to open something on the web page, it appears to log me out (asking me to provide the root password). I think I'll give up on this idea; doesn't seem to be well supported for PI.

    • Mohamed says:

      i've the same problem of Marian, with web page, my PI is buging or i don't know what, everytime i am trying to open a webpage, while Ping or ping etc are working from PC's behind the pi-router (LAN Side), this is strange.
      i've thought that was a power issue, i changed my p-supply, the problem persists.

      • Mohamed says:

        PS: i am also getting the MAC 00:00:00:00:00:00 for ETH1 (UsbToEthernetAdapter) in the OpenWRT-GUI.

        • Mohamed says:

          Hi Marian, I found out my problem: incompatibility between the Pi and the USB-ETH-ADAPER,


  5. Marian says:

    I got it to work. It didn't boot my first two SD cards, but it worked on the 3rd! Weird.
    Anyway... the PI does not see the USB Network Card. With only one network interface, is not very useful. Did anyone get it working with a USB NIC?

    • EX says:

      You must have USB basic support installed. You can check kmod-usb-net* packages and look into 'dmesg' and see if your USB network adapter got detected.
      This may help you:

  6. chandrakant sahoo says:

    Raspberry Pi B+ board is not able to boot openwrt after following the above steps.
    any solution please !!!

  7. John Gibbs says:

    Just to warn people, Luci (the web gui) does not come pre-installed in the openwrt image so there is no webui at until you install Luci or another GUI package

Leave a Reply

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


Your browser is out-of-date. Upgrade your browser today! Internet Explorer | FireFox | Chrome