Documentation

This is the documentation section of the OpenWrt Wiki, if you want to contribute read Wiki Maintainers.
Supported Devices are listed in the Table of Hardware.
The old OpenWrt Manual can be found here.

Configuring OpenWrt

Recipes

Recipes are articles explaining common OpenWrt setup scenarios like routed client mode.

Page Description
3g/UMTS dongle Use 3g/UMTS USB Dongle for WAN connection
Bridged AP Howto bridge wireless and ethernet in Access Point mode
Routed AP Howto to put wireless and ethernet in different subnets
Client Mode General discussion of client mode wireless
Routed Client Howto configure a routed or masqueraded wireless client
Bridged Client (Broadcom) Howto define a wireless client bridge with proprietary Broadcom drivers
WDS (Broadcom) Howto define AP-to-AP WDS with proprietary Broadcom drivers
WDS (Atheros) Howto setup AP-to-Sta WDS with madwifi and mac80211 drivers
Multi-SSID Howto define multiple virtual Access Points
Guest WLAN Howto define a WLAN for your guests
Dumb AP Make your router an plain Access Point that's really just that, no routing, no DHCP, no nothing
install.packages.on.USB-Stick Install packages on an USB-Stick without using extroot

HOWTOs

HOWTOs cover additional tasks possible with OpenWrt, e.g. setting up a printer server. Using the vanilla firmware, install packages via opkg and set up the configuration. Use the templates if you want to contribute.

Cat Page Description
Basic Howtos
beginner Basic Howtos Stuff explained on the Wiki-Pages for some devices, but not for others
beginner Basic Configuration A help for beginners, an overview for old stagers
Overviews
network Act as Server Overview over overviews: Offer services over the network (overview)
network Act as Client Overview over overviews: Use services offered over the network (overview)
administer WebUIs Web User Interfaces related articles (overview)
administer Statistics Collect Statistical Data (overview)
sys Logging overview Log related articles (overview)
network Web Server overview HTTP Server related articles (overview)
network Proxy Server overview Proxy Server related articles (overview)
network Wireless Wireless related articles (overview)
network IPv6 IPv6 related articles (overview)
network E-Mail overview E-Mail related articles (overview)
network more than internet If you have Double Play/Triple Play/Quadruple Play
network VoIP everything VoIP related
network IPTV everything IPTV related
periphery USB overview USB related articles (overview)
periphery Printers Offer access to a printer connected to OpenWrt over the network
other Databases Setup Database management systems like MySQL, PostgreSQL, …
security Certificates Authentication with the help of certificates
security VPN overview Overview over the usage of VPNs
beginner Basic Understanding A help for beginners to understand their system better
Articles assortment
network Access Cable/DSL-Modem How to access your Cable-/DSL-Modem
network Configure Motorola cable modem How to configure your Motorola cable modem (DOCSIS)
network Traffic Control Packet Scheduler, QoS, Traffic Shaping, Traffic Prioritizing
network Netfilter Packet filter, firewall, iptables, ip6tables, ebtables, arptables
sys Bandwidth Monitoring How to track bandwidth usage
sys Obtain Firmware Four ways to obtain a Firmware-Image-File
network Dynamic DNS Create a domain name that points to your IP
network Define a DMZ Separate a switch port and make it a DMZ
sys EAD Installing and using the Emergency Access Daemon
sys Extroot Using external storage as root filesystem
sys Kexec Boot a kernel from internal flash and then execute another kernel on external storage
periphery I²C over USB Using USB-I²C adapters on OpenWrt
network NFS Server Howto setup a Network File System (NFS) server on OpenWrt
PulseAudio Since trunk 2011-01 we can install PulseAudio
NetBoot NetBoot
Qemu Running OpenWrt in Qemu
sys VirtualBox Running OpenWrt in VirtualBox
sys VMWare Running OpenWrt in VMWare
security wget Certificates Installing SSL certificates for wget
security Mini-Httpd & SSL How to get mini-httpd and SSL working
sys Hardware Buttons Make the Hardware Buttons toggle events
sys Xen Running OpenWrt in Xen
network UDP multicast IPTV / UDP multicast
util BoxBackup Running BoxBackup on OpenWrt
external links.external.howtos Not everything can be in this wiki
network Connect by L2TP Connect to ISP using L2TP with Dual Access
network Port Forwarding How to and examples of different cases of Port Forwarding
network Kerberos Server How to setup a Kerberos Server for secure authentication

UCI configuration

OpenWrts central configuration is located in the /etc/config/ directory.

File Description
Basic
/etc/config/dhcp Dnsmasq configuration and DHCP settings
/etc/config/dropbear SSH server options
/etc/config/firewall NAT, packet filter, port forwarding, etc.
/etc/config/network Switch, interface and route configuration
/etc/config/system Misc. system settings
/etc/config/timeserver Time server list for rdate
/etc/config/wireless Wireless settings and wifi network definition
IPv6
/etc/config/6relayd IPv6-Server and Relay (RD, DHCPv6 & NDP)
/etc/config/ahcpd Ad-Hoc Configuration Protocol (AHCP) server and forwarder configuration
/etc/config/aiccu AICCU client configuration
/etc/config/dhcp6c WIDE-DHCPv6 client
/etc/config/dhcp6s WIDE-DHCPv6 server
/etc/config/gw6c GW6c client configuration
/etc/config/radvd Router Advertisement (radvd) configuration
Other
/etc/config/bbstored BoxBackup server configuration
/etc/config/etherwake Wake-on-Lan: etherwake
/etc/config/freifunk_p2pblock Uses iptables layer7-, ipp2p- and recent-modules to block p2p/filesharing traffic
/etc/config/fstab Mount points and swap
/etc/config/hd-idle Another idle-daemon for attached hard drives
/etc/config/httpd Web server options (Busybox httpd, deprecated)
/etc/config/ipset-dns Configure http://git.zx2c4.com/ipset-dns/about/ ipset-dns
/etc/config/luci Base LuCI config
/etc/config/luci_statistics Configuration of Statistics packet
/etc/config/mini_snmpd mini_snmpd settings
/etc/config/minidlna MiniDLNA settings
/etc/config/mjpg-streamer Streaming application for Linux-UVC compatible webcams
/etc/config/mountd OpenWrt automount daemon
/etc/config/mroute Configuration files for multiple WAN routes
/etc/config/multiwan Simple multi WAN configuration
/etc/config/ntpclient Getting the correct time
/etc/config/p910nd config for non-spooling Printer daemon p910nd.server
/etc/config/pure-ftpd Pure-FTPd server config
/etc/config/qos Implementing Quality of Service for the upload
/etc/config/racoon racoon IPsec daemon
/etc/config/samba settings for the Microsoft file and print services daemon
/etc/config/snmpd SNMPd settings
/etc/config/sshtunnel Settings for the package sshtunnel
/etc/config/stund STUN server configuration
/etc/config/tinc tinc package configuration
/etc/config/transmission BitTorrent configuration
/etc/config/uhttpd Web server options (uHTTPd)
/etc/config/upnpd miniupnpd UPnP server settings
/etc/config/users user database for different services
/etc/config/ushare uShare UPnP server settings
/etc/config/vblade vblade userspace AOE target
/etc/config/vnstat vnstat downloader settings
/etc/config/wifitoggle Script to toogle WiFi with a button
/etc/config/wol Wake-on-Lan: wol
/etc/config/wshaper wondershaper qos script settings
/etc/config/znc ZNC bouncer configuration

→ Read more...

Building

These articles focus on compiling OpenWrt sources.

Page Description
OpenWrt Buildroot — About About OpenWrt Buildroot
OpenWrt Buildroot – Installation Setting up an OpenWrt build system
OpenWrt Buildroot – Usage Using the build system to compile OpenWrt
Build VM Using the build system to compile OpenWrt within a virtual machine
Feeds Working with package feeds
Image Generator The Image Generator (aka Image builder) lets you create custom images without having to compile or setting up a build system
SDK Using the SDK to compile package sources

Build HOWTOs

Build-HowTos include doing things from scratch and then using the Build System to obtain an own firmware (see template_howtobuild):

Page Description
Netgear WNDR3700 Build the Netgear WNDR3700 firmware
Seagate Dockstar Build the Seagate Dockstar firmware
TP-Link TL-MR3420 Build the TP-Link TL-MR3420 firmware
3G-Dongle Build firmware including UMTS-Modem support
single package Compile and package only one single package

Developing

Documentation of specific development related tasks.

Page Description
Hacking
First Steps First Steps on an unsupported device
Add a platform General considerations for adding new platform support
Add a device Howto add support for a new device
Kernel stuff
drivers Stuff related to drivers
OpenWrt
Debugging On Debugging
Build environments Manage different configurations and files in a single Buildroot
Software Libraries What libraries you could use
Crosscompile Cross compile sources into binaries without packaging them
Packages Packaging software
Feeds Working with package feeds
Dependencies Using dependencies for packages
Patches Adding, modifying and refreshing patches
Bugs Reporting and tracking bugs
UCI-Lua Lua bindings for UCI
LuCI Developing LuCI addons
Config scripting Using UCI configuration files in shell scripts
Network scripting Network scripting and protocol handler API
GNU Debugger Howto use the GNU Debugger
Eclipse IDE Howto use the Eclipse IDE including GNU Debugger

Technical references

Articles covering background information and technical description of various OpenWrt components.

Page Description
Utilities
OPKG OPKG package manager reference
mtd mtd utility reference
sysupgrade sysupgrade script
UCI UCI reference
LuCI LuCI reference (Homepage)
netifd Netifd (Network Interface Daemon) reference
Functioning
Flash Layout How data is stored on the flash
Filesystems About the different file systems
The Bootloader About Booloaders
Booting About the boot process
Init Scripts Init script implementation reference
Preinit Preinit, Mount Root, and First Boot Scripts
Block Mount Block Device Mounting
Hotplug Hotplug
Boot & Init Requirements What the new init system needs to do to be feature complete compared to current, and goals for improvement
General
Brcm63xx Imagetag Information on the firmware image format for brcm63xx
TRX vs TRX2 vs BIN Information on the different file types
External Documentation Links to external documentation

Frequently Asked Questions (FAQ)

Back to top

zh-tw/doc/start.txt · Last modified: 2013/06/27 12:23 by lorema