This article may rely excessively on sources too closely associated with the subject, potentially preventing the article from being verifiable and neutral. (November 2013) (Learn how and when to remove this template message)
OpenWrt 15.05 ("Chaos Calmer") login screen
|Source model||Open source|
|Initial release||January 2004|
|Latest release||15.05.1 (Chaos Calmer) (March 16, 2016[±])|
|Latest preview||15.05-rc3 Chaos Calmer (15 July 2015[±])|
|Available in||22 languages|
|Platforms||50 different platforms using the following Instruction sets: AVR32, ARM, CRIS, m68k, MIPS, PowerPC, SPARC, SuperH, Ubicom32, x86, x86-64|
|Kernel type||Monolithic (Linux)|
|Default user interface||CLI, WebUIs|
|License||Free software (GPL and other licenses)|
OpenWrt is an open source project for embedded operating system based on Linux, primarily used on embedded devices to route network traffic. The main components are Linux, util-linux, musl, and BusyBox. All components have been optimized to be small enough for fitting into the limited storage and memory available in home routers.
OpenWrt is configured using a command-line interface (ash shell), or a web interface (LuCI). There are about 3500 optional software packages available for installation via the opkg package management system.
OpenWrt can run on various types of devices, including CPE routers, residential gateways, smartphones, pocket computers (e.g. Ben NanoNote), and laptops. It is also possible to run OpenWrt on personal computers, which are most commonly based on the x86 architecture.
The project came into being because Linksys built the firmware for their WRT54G series of wireless routers from publicly available code licensed under the GPL. Under the terms of that license, Linksys was required to make the source code of its modified version available under the same license, which in turn enabled independent developers to create additional derivative versions. Support was originally limited to the WRT54G series, but has since been expanded to include many other chipsets, manufacturers and device types, including Plug Computers and Openmoko mobile phones.
Using this code as a base and later as a reference, developers created a Linux distribution that offers many features not previously found in consumer-level routers. Some features formerly required proprietary software. Before the introduction of OpenWrt 8.09, using Linux 2.6.25 and the
b43 kernel module, WLAN for many Broadcom-based routers was only available through the proprietary
wl.o module that was also provided for Linux 2.4.x only.
The code names of OpenWrt branches are named after alcoholic beverages, usually including their recipes in the MOTD as well, cf. White Russian, Kamikaze, Backfire, Attitude Adjustment, Barrier Breaker.
In May 2016, OpenWrt was forked by a group of core OpenWrt contributors due to disagreements on internal process. The fork was dubbed Linux Embedded Development Environment. The schism was nominally reconciled a year later in May 2017 pending approval of the LEDE developers. The proposed remerger will preserve the OpenWrt branding but use many of the LEDE processes and rules. The remerge proposal vote was passed by LEDE developers in June 2017 and it was formally announced in January 2018.
|Tagged||Code Name||Version||Release date||Linux kernel||C standard library||Binary packages||Source packages||Notes|
|N/A||Old version, no longer supported: pre Buildroot-NG||0.x||N/A||N/A||uClibc||474||≈ 310|
|r6268||Old version, no longer supported: White Russian||0.9||January 2006||2.4.30||≈ 360||≈ 140||NVRAM-based,
|r7428||Old version, no longer supported: Kamikaze||7.06||June 2007||2.6.19||≈ 750||≈ 450||Using
|r7832||Old version, no longer supported: Kamikaze||7.07||July 2007||2.6.21||≈ 790||≈ 475||New platform:
|r8679||Old version, no longer supported: Kamikaze||7.09||September 2007||≈ 630||≈ 500|
|r14547||Old version, no longer supported: Kamikaze||8.09||September 2008||2.6.26||≈ 1,400||≈ 875||New platform:
|r16279||Old version, no longer supported: Kamikaze||8.09.1||June 2009||≈ 1,400||≈ 875|
|r18961||Old version, no longer supported: Kamikaze||8.09.2||January 10, 2010||≈ 1,400||≈ 875|
|r20742||Old version, no longer supported: Backfire||10.03||April 7, 2010||2.6.32||≈ 2,350||≈ 1,050||Supported platforms:
|r29594||Old version, no longer supported: Backfire||10.03.1||December 21, 2011||eglibc
|≈ 2,950||≈ 1,175|
|r36088||Old version, no longer supported: Attitude Adjustment||12.09||April 25, 2013||3.3||eglibc||≈ 3,450||≈ 1,150||CoDel (network scheduler) backported from Linux 3.5 to 3.3. New platforms:
|r42625||Old version, no longer supported: Barrier Breaker||14.07||October 2, 2014||3.10.49||musl
|r46767||Old version, no longer supported: Chaos Calmer||15.05||September 11, 2015||3.18.20||musl
|?||?||nftables (available since Linux kernel 3.12); New platforms: TBA if any|
|r49022||Current stable version: Chaos Calmer||15.05.1||March 16, 2016||3.18.23|
|trunk||Future release: Designated Driver||development||N/A||4.4/4.9/4.14||musl||uClibc
With the Attitude Adjustment (12.09) release of OpenWrt, all hardware devices with 16 MB or less RAM are no longer supported as they can run out of memory easily. Older Backfire (10.03) is recommended instead for
bcm47xx devices, as issues for those devices came from dropping support for the legacy Broadcom target
OpenWrt follows the bazaar-philosophy and is known for an abundance of options. Features include:
- A writable root file system, enabling users to add, remove or modify any file. This is accomplished by using overlayfs to overlay a read-only compressed SquashFS file system with a writable JFFS2 file system in a copy-on-write fashion. JFFS2 supports flash wear leveling.
- The package manager opkg, similar to dpkg, enables users to install and remove software. The package repository contains about 3500 packages. This contrasts with Linux-based firmware based on read-only file systems without the possibility to modify the installed software without rebuilding and flashing a complete firmware image.
- A set of scripts called UCI (unified configuration interface) intended to unify and simplify the configuration of the entire system
- Extensible configuration of the entire hardware drivers, e.g. built-in network switches and their VLAN-capabilities, WNICs, DSL modems, FX, available hardware buttons, etc.
- Exhaustive possibilities to configure network-related features, like:
- IPv4 support.
- IPv6 native stack:
- Routing through iproute2, Quagga, BIRD, Babel etc.
- Mesh networking through B.A.T.M.A.N., OLSR and IEEE 802.11s-capabilities of the WNIC drivers and other ad hoc mesh routing protocols that have been implemented within Linux.
- Wireless functionality, e.g. make the device act as a wireless repeater, a wireless access point, a wireless bridge, a captive portal, or a combination of these with e.g. ChilliSpot, WiFiDog Captive Portal, etc.
- Wireless security: Packet injection, e.g. Airpwn, lorcon, e.a.
- Stateful firewall, NAT and port forwarding through netfilter; additionally PeerGuardian is available
- Dynamically-configured port forwarding protocols UPnP and NAT-PMP through upnpd, etc.
- Port knocking via knockd and knock
- TR-069 (CWMP) client
- IPS via Snort (software)
- Active queue management (AQM) through the network scheduler of the Linux kernel, with many available queuing disciplines. CoDel has been backported to Kernel 3.3. This encapsulates Traffic shaping to ensure fair distribution of bandwidth among multiple users and Quality of Service (QoS) for simultaneous use of applications such as VoIP, online gaming, and streaming media without experiencing the negative impacts of link saturation.
- Load balancing for use with multiple ISPs using source-specific routing
- IP tunneling (GRE, OpenVPN, pseudowire, etc.)
- Extensible realtime network monitoring and statistics through e.g. RRDtool, Collectd, Nagios, Munin lite, Zabbix, etc.
- Domain Name System (DNS) and DHCP through Dnsmasq, MaraDNS, etc.
- Dynamic DNS services to maintain a fixed domain name with an ISP that does not provide a static IP address
- Wireless distribution system (WDS) including WPA-PSK, WPA2-PSK, WPA-PSK/WPA2-PSK Mixed-Mode encryption modes
- OpenWrt supports any hardware that has Linux support; devices that can be connected (e.g. over USB) to an embedded device include
- Notable software packages to use the hardware support are:
- An extensive Ajax-enabled web interface, thanks to the LuCI project
- Regular bug fixes and updates, even for devices no longer supported by their manufacturers
Before release 8.09, OpenWrt had a minimal web interface. In OpenWrt releases 8.09 and newer, a more capable web interface is included. This interface is based on LuCI, an MVC framework written in the Lua programming language.
The X-Wrt project provides an alternative web interface, named webif² in the package repositories, for the current and previous versions of OpenWrt.
OpenWrt's development environment and build system, known together as OpenWrt Buildroot, are based on a heavily modified Buildroot system. OpenWrt Buildroot is a set of Makefiles and patches that automates the process of building a complete Linux-based OpenWrt system for an embedded device, by building and using an appropriate cross-compilation toolchain.
Embedded devices usually use a different processor than the one found in host computers used for building their OpenWrt system images, requiring a cross-compilation toolchain. Such a compilation toolchain runs on a host system, but generates code for a targeted embedded device and its processor's instruction set architecture (ISA). For example, if a host system uses x86 and a target system uses MIPS32, the regular compilation toolchain of the host runs on x86 and generates code for x86 architecture, while the cross-compilation toolchain runs on x86 and generates code for the MIPS32 architecture. OpenWrt Buildroot automates this whole process to work on the instruction set architectures of most embedded devices and host systems.
- Makes it easy to port software across architectures
- Uses kconfig (Linux kernel menuconfig) for the configuration of all options
- Provides an integrated cross-compiler toolchain (gcc, ld, uClibc etc.)
- Provides an abstraction for autotools (automake, autoconf), cmake and SCons
- Handles standard OpenWrt image build workflow: downloading, patching, configuration, compilation and packaging
- Provides a number of common fixes for known badly behaving packages
Besides building system images, OpenWrt development environment also provides a mechanism for simplified cross-platform building of OpenWrt software packages. Source code for each software package is required to provide a Makefile-like set of building instructions, and an optional set of patches for bug fixes or footprint optimizations.
OpenWrt runs many different routers, and includes a table of compatible hardware on its website. In its buyer's guide, it notes that users recommend devices equipped with wireless chips from either Qualcomm's Atheros or Ralink (now MediaTek).
OpenWrt, especially its Buildroot build system, has been adopted many times:
- Freifunk and other mesh network communities
- Bufferbloat.net (Cerowrt)
- SIMET Box, developed by NIC.br, is OpenWrt-based
- IETF IPv6 integration projects HIPnet and HomeNet are OpenWrt-based
- LEDE is founded as a spin-off of the OpenWrt project and shares many of the same goals.
- CeroWrt – with a purpose to complement the debloat-testing kernel tree and provide a platform for real-world testing of bufferbloat fixes
- Coova chilli – OpenWrt-based with focus on wireless hotspots, a fork of chillifire with focus on wireless hotspot management
- Gargoyle – a web interface for OpenWrt with a strong emphasis on usability that later forked into a separate distribution
- Flukso – Wireless sensor nodes using an Atheros AR2317 chipset running a patched OpenWrt OS for communication. Sources and hardware schematics available on GitHub.
- Fon – OpenWrt-based wireless routers acting as hotspots. Sources and toolchain available on fonosfera.org
- Linino – OpenWrt-based distribution for the MIPS-based Arduino Yùn: GitHub Project
- Midge Linux – an OpenWrt-based distribution for devices based on Infineon Technologies ADM-5120 SoCs, such as Edimax BR-6104K and BR-6104KP.
- OpenSAN – iSCSI target Storage Area Network realization.
- PacketProtector – OpenWrt-based security distribution that includes IDS, IPS, VPN, and web antivirus capabilities. Packages included Snort, Snort-inline, FreeRADIUS, OpenVPN, DansGuardian and ClamAV. These tools were accessible via the old web GUI management interface of OpenWrt, called X-Wrt or webif^2. Project ended on June 7, 2012.
- The Turris Omnia router runs on an OpenWrt derivative
- Diverse grassroots projects for wireless community networks, including Freifunk, Libre-Mesh and qMp
- libreCMC – OpenWrt-based distribution without non-free software or binary blobs, endorsed by the Free Software Foundation
- "Chaos Calmer 15.05.1". 16 March 2016. Retrieved 21 March 2016.
- "Chaos Calmer 15.05-rc3". OpenWrt Forum. 13 June 2015. Retrieved 13 June 2015.
- "LuCI Translation Portal". 2004-09-01. Retrieved 2010-12-31.
- "Config.in in trunk/target – OpenWrt". Dev.OpenWrt.org. 2013-11-22. Retrieved 2014-02-13.
- Fietkau, Felix (16 June 2015). "OpenWrt switches to musl by default". Retrieved 16 June 2015.
- Linksys WRT54G and the GPL on lkml (7 Jun 2003)
- The Open Source WRT54G Story By Aaron Weiss (November 08, 2005)
- Linksys Releases GPLed Code for WRT54G on slashdot (July 2003)
- Willis, Nathan (May 11, 2016). "LEDE and OpenWrt". LWN.net. Retrieved 2017-08-31.
- Sharwood, Simon (10 May 2017). "OpenWRT and LEDE agree on Linux-for-routers peace plan". theregister.co.uk. Retrieved 2017-08-31.
- Mehrtens, Hauke (June 26, 2017). "LEDE call for vote on remerge proposal V3". LEDE-DEV mailing list. Retrieved 2017-08-31.
- Wich, Jo-Philipp (Jan 2, 2018). "Announcing the OpenWrt/LEDE merge". LEDE Project Forum. Retrieved 2018-01-10.
- "Release Notes Kamikaze 8.09.2". openwrt.org. 2010-01-10. Retrieved 2013-04-26.
- "Release Notes Backfire 10.03". openwrt.org. 2010-04-07. Retrieved 2013-04-26.
- "Release Notes Backfire 10.03.1". openwrt.org. 2011-12-21. Retrieved 2013-04-26.
- "Release Notes Attitude Adjustment 12.09". openwrt.org. 2013-04-25. Retrieved 2013-04-26.
- "OpenWrt BarrierBreaker 14.07". openwrt.org. October 2014.
- "kernel: update to 3.10.49 – OpenWrt". dev.openwrt.org. 2014-07-20.
- Freescale i.MX support
- "OpenWrt Chaos Calmer 15.05". openwrt.org. September 2015.
- "[OpenWrt-Devel] Chaos Calmer 15.05-rc3". 2015-07-16.
- "[OpenWrt-Devel] [PATCH 1/2] toolchain: The glorious return of glibc, ver 2.21". 2015-03-11.
- "Chaos Calmer 15.05.1". 16 March 2016. Retrieved 21 March 2016.
- "Chaos Calmer 15.05.1". 16 March 2016. Retrieved 21 March 2016.
- "Changeset 46846: change banner to Designated Driver release". 2015-09-11.
- "[OpenWrt-Devel] OpenWrt switches to musl by default". 2015-06-16.
- "Release Notes for Attitude Adjustment (12.09 final)". openwrt.org. 2013-04-25. Retrieved 2013-09-26.
- "OpenWrt: Table of Hardware". openwrt.org. Retrieved 2013-09-26.
- "Debating overlayfs". June 15, 2011.
- "OpenWrt partition layout".
- "OpenWrt Unified Configuration Interface".
- freecwmp is a CWMP client for OpenWrt
- "Changeset 31756 – OpenWrt". Dev.OpenWrt.org. 2012-05-16. Retrieved 2014-02-13.
- "LuCI project". Retrieved February 28, 2009.
- "OpenWrt 8.09 release notes". Retrieved February 23, 2009.
- "OpenWrt Buildroot – About". openwrt.org. Retrieved 2013-10-21.
- "OpenWrt Buildroot - Usage and documentation". openwrt.org. 2006-01-08. Retrieved 2013-10-21.
- Tao Jin (2012-02-13). "OpenWrt Development Guide" (PDF). Wireless Networks Lab, CCIS, NEU. Retrieved 2013-10-21.
- "Creating packages". openwrt.org. Retrieved 2013-10-21.
- "Table of Hardware [OpenWrt Wiki]". wiki.openwrt.org. Retrieved 2016-10-06.
- "Buyers' Guide [OpenWrt Wiki]". wiki.openwrt.org. Retrieved 2016-10-06.
- "Simet Box". Retrieved 2017-09-14.
- "CeroWrt Wiki". Retrieved 2015-09-16.
- "ANNOUNCE: debloat-testing kernel git tree". LWN.net. Retrieved 2014-02-13.
- ""closing time" message from author on PacketProtector forum".
- "Free Software Foundation adds libreCMC to its list of endorsed distributions". FSF.org. 2014-09-04. Retrieved 2014-12-21.
|Wikimedia Commons has media related to OpenWrt.|