1. About this manual
This is a Wiki, a set of documents written by the OpenWrt developers and community. Nearly every page on this site can be edited, you just need to create an account.
Please read the manual. If you have any questions about anything in the manual, post a message in the forums or on the Mailing Lists
1.1. The OpenWrt manual
1.1.1. Installation and Usage
- Supported hardware
- Choosing the right firmware
- Installing OpenWrt
- Upgrading from previous OpenWrt install
- Bootup
- Setting a password
- Why no default password?
- What if I can't access telnet when first booting?
- What if I can't access SSH after setting a password?
- Why does it reject my password or display SSH warnings after upgrading?
- Notes about SquashFS firmware
- Notes about JFFS2 firmware
- Package management
- Failsafe mode
- Resetting to defaults
- Recovering from bad firmware
- Getting help
1.1.2. WhiteRussian RC5 (Stable) Configuration
OpenWrt WhiteRussian Configuration
- NVRAM
- Network configuration
- Ethernet switch configuration
- Wireless configuration
- Basic settings
- MAC filter
- WEP encryption
- WPA encryption
- Wireless Distribution System (WDS) / Repeater / Bridge
- WDS Routed Networks (P2P)
- A note on encryption with WDS
- Wireless client / wireless bridge
- Basic system configuration and usage
- busybox - The Swiss Army Knife of Embedded Linux
- cron - job scheduler
- syslog - Logging
- dropbear - Secure Shell server
- iptables - Firewall
- dnsmasq - DNS and DHCP server
- Time
- Timezone
- HOWTOs / Additional Configuration
1.1.3. Kamikaze (Experimental) Configuration
OpenWrt Kamikaze Configuration
2. Appendix: FAQ
- Installation
- Will OpenWrt run on <fill in the blank> ?
- How do I identify my hardware version?
- Which image should I use?
- How do I install/flash OpenWrt?
- Do I need to run firstboot on every boot?
- How do I edit files on the SquashFS image?
- How do I recover / boot in failsafe mode?
- What TFTP client should I use to flash my Wrt?
- Can I flash the OpenWrt image when I changed the LAN IP?
- How do I convert a .bin image to .trx to use with mtd?
- Misc
- Where can I find the FAQ?
- When should I NOT install OpenWrt?
- How do I change NVRAM settings?
- How to create a NVRAM dump for debugging?
- Where should I send bug reports?
- How do I find out the installed OpenWrt version
- How do I clean up the NVRAM variables (the safe way)?
- How often can I write on the flash chip?
- Where can I find packages?
- Why isn't a package for ____ available?
- How much space is available for the JFFS2 partition?
- How do I reflash / How do I revert back to my previous firmware?
- Does OpenWrt have a web interface?
- Why is the OpenWrt firmware so bare?
- Who maintains OpenWrt?
- How do I access the syslog messages?
- How do I have it do something every YYY seconds/minutes?
- What does /sbin/wifi do?
- How do I open a WRT54G/WRT54GS?
- When using the SSH client from OpenWrt, I get the following message: "no auths methods could be used".
- Networking
- How do I create a DHCP server?
- Where should I put custom firewall rules?
- How do I configure QoS aka traffic shaping in OpenWrt?
- How do I route wireless instead of a bridging LAN and WIFI?
- How do I set the timezone and make it stick between reboots?
- What is br0?
- How do I configure MAC address cloning in OpenWrt?
- How do I enable WEP encryption?
- How do I use WiFi Protected Access (WPA)?
- How can I enable Client Mode?
- Wireless Distribution System (WDS) / Repeater / Bridge
- How do I disable ESSID broadcast?
- Can I adjust the transmit power?
- What is the difference between wl0_* and wl_* variables?
- How do I configure PPPoE for Internet access?
- How do I configure DHCP for internet access?
- How do I configure PPTP for internet access?
- iptables -F locks you out of telnet/ssh
- Development