User Tools

Site Tools


Quick Image Building Guide

This is a very short guide on how to compile your first OpenWrt snapshot firmware. If you want to compile a stable release, use the Beginners guide to building your own firmware as a guide.

This guide does not cover any pitfalls, but provides a quick way if everything goes well. Alternative guides to achieving the same goal: Using the Image Builder, Beginners guide to building your own firmware.

The development branch can contain experimental code that is under active development and should not be used for production environments. Snapshot images may support additional hardware; however, it is experimental, considered unstable, and sometimes won't compile.

Prebuilt snapshot images do not come with any web interface or GUI. You will need to be comfortable using a command line and remote shell to install one yourself → See How to install LuCI and Use SSH to connect to the internet and install Luci Web interface

→

First we need to make sure the dependencies are installed. See these examples of package installations.

For Debian/Ubuntu:

sudo apt-get update
sudo apt-get install subversion g++ zlib1g-dev build-essential git python python3 python3-distutils libncurses5-dev gawk gettext unzip file libssl-dev wget libelf-dev ecj fastjar java-propose-classpath

For Ubuntu 18.04 or later:

sudo apt-get install build-essential libncursesw5-dev python unzip   

For Fedora 30:

sudo dnf install @c-development @development-tools @development-libs zlib-static elfutils-libelf-devel gawk unzip file wget python3

Get the OpenWrt source code:

umask 0022

git clone

cd openwrt

./scripts/feeds update -a
./scripts/feeds install -a

make menuconfig

The last command will open a menu.

If you want to build images for the “TL-WR841N v11” Wifi-Router, select:

  • “Target System” ⇒ “Atheros AR7xxx/AR9xxx”
  • “Subtarget” ⇒ “Devices with small flash”
  • “Target Profile” ⇒ “TP-LINK TL-WR841N/ND v11

In the menu, select Exit and then Yes to save your settings. Now build the images. That may take some time:


Afterwards, the images can be found in ./bin/targets/ar71xx/generic/ - done. 8-)

  • The *-factory.bin images are for the first installation.
  • The *-sysupgrade.bin images are for the updating existing OpenWrt installations.


  • For recompiling the images, just execute make again.
  • For faster compiling, use make -j N, where N is the number of CPU cores + 1. Be aware that this method is prone to errors during compiling. In case you encounter compile errors, your very first step is to compile again without -j N. Use of make download prior to parallel compilation is recommended to prevent some of these errors (-jN is generally safe for the download step for those with faster Internet connectivity.)
  • Change settings with make menuconfig and compile again.
  • You can include custom files in your image by placing them in <buildroot>/files, e.g. if you want to have my_config included in your image in the directory /etc/config/<buildroot>/files/etc/config/my_config. If the files directory doesn't exist on your buildsystem, then create it.
This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies
docs/guide-developer/quickstart-build-images.txt · Last modified: 2020/06/01 18:51 by ja