How to Install OpenWrt on Your Wireless Router (Step-by-Step Guide)

A beginner-friendly guide to flashing OpenWrt 25.12 on a supported router: compatibility checks, the right firmware image, the flash itself, and the first settings to lock down afterward.

Updated on
How to Install OpenWrt on Your Wireless Router (Step-by-Step Guide)

Last updated: November 2026

Key Takeaways

  • OpenWrt is free, open-source router firmware that replaces the software your manufacturer installed. The current stable series is OpenWrt 25.12 (version 25.12.6 as of November 2026). The older 24.10 series stopped receiving security updates in September 2026, so new installs should use 25.12.
  • Before you flash anything, confirm your exact model and hardware revision on the OpenWrt Table of Hardware, then download the "factory" (install) image from the OpenWrt Firmware Selector. Flashing an unsupported device, or the wrong file, can permanently damage the router.
  • A first install takes 15 to 30 minutes over a wired connection: upload the image through your stock firmware's upgrade page, log in to OpenWrt at 192.168.1.1, set a root password, and turn on Wi-Fi (it is off by default).

What is OpenWrt and why install it?

OpenWrt is a Linux-based operating system built for routers and other small networking devices. It replaces the stock firmware that shipped with your router and gives you a full, configurable network operating system in its place, with a web interface called LuCI and a package system that lets you add features on demand.

Most stock router firmware gets updates for two or three years, then stops. OpenWrt keeps supported hardware patched for far longer, which is the main reason people install it on routers that still work fine but no longer get fixes from the manufacturer. If you want the broader case for open-source firmware, read why you should flash your router with open-source firmware.

What do you get that stock firmware lacks?

  • Ongoing security updates: OpenWrt publishes regular service releases with kernel, DNS, and wireless fixes, and the project announces which versions are still supported.
  • A configurable firewall: OpenWrt uses nftables (firewall4) with zone-based rules you can edit, instead of the fixed NAT settings most consumer routers expose.
  • Network-wide ad and tracker blocking: Packages such as adblock-fast filter DNS requests for every device on your network with no per-device setup. Pair it with the resolver settings in our router DNS guide.
  • Router-level VPN: WireGuard support is built in, so you can route every device through Proton VPN or Mullvad VPN without installing anything on each one. Our hardware VPN router guide covers that setup.
  • Guest networks and device isolation: Put smart TVs, cameras, and other IoT devices on their own network segment with firewall rules that keep them away from your computers and phones.
  • Longer hardware life: A router that lost manufacturer support can stay secure for years on OpenWrt, which matters given the NSA and FBI guidance on end-of-life routers.

What is new in OpenWrt 25.12?

If you last looked at OpenWrt a year or two ago, a few things have changed. The table below covers the differences you will notice as a new user.

Area OpenWrt 24.10 and earlier OpenWrt 25.12
Package manager opkg apk (Alpine Package Keeper); most package names are unchanged, but the commands differ
Linux kernel 6.6 6.12, with a newer wireless stack
Upgrades Attended Sysupgrade was an optional install Attended Sysupgrade is installed by default, so upgrades keep your packages and settings in a few clicks
Supported devices Roughly 2,000 More than 2,200, including 180+ added since 24.10
Support status 24.10 security updates ended September 2026 Current stable series; service releases continue

Is your router compatible with OpenWrt?

Only routers listed on the OpenWrt Table of Hardware are supported, and support is specific to the hardware revision, not just the model name. This is the step that prevents bricked routers, so do not skip it.

How do you check the Table of Hardware?

  1. Find the model number and hardware version on the sticker on the bottom or back of your router. The version looks like "Ver 1.0," "v2.1," or "Rev A."
  2. Go to the OpenWrt Table of Hardware and search for your model.
  3. Open your device's page. Confirm the hardware version matches, that the "Supported Current Release" column lists a 25.12 version, and read the installation notes. Some devices need an intermediate firmware or a TFTP flash instead of the web-upload method in this guide.

If your router is not listed, or your hardware version is not listed, stop here. Installing OpenWrt on an unsupported device can leave it unusable with no recovery path.

How much flash and RAM does OpenWrt need?

Routers with 4 MB of flash and 32 MB of RAM have not been supported for several years, and 8 MB / 64 MB devices can install 25.12 but leave almost no room for packages such as ad blocking or a VPN client. For a comfortable install, look for at least 16 MB of flash and 128 MB of RAM. The Table of Hardware lists both numbers for every device.

Which routers are the easiest way to run OpenWrt?

If you do not already own a supported router, two options remove most of the risk from this process:

  • OpenWrt One: The project's own router, built with Banana Pi. It ships with OpenWrt preinstalled, so there is nothing to flash, and it has a hardware switch for separate NOR and NAND flash so a bad flash can always be recovered. Specs: Wi-Fi 6, a 2.5 Gbps WAN port, 1 GB of RAM, and an NVMe slot. Details are on the OpenWrt One wiki page.
  • GL.iNet Flint 2 (GL-MT6000): A Wi-Fi 6 router that ships with GL.iNet's OpenWrt-based firmware and is also officially supported by stock OpenWrt, with a straightforward web-upload install path. GL.iNet Flint 2 on Amazon (affiliate link). As an Amazon Associate I earn from qualifying purchases.

A used TP-Link Archer, Netgear, or Linksys model from the Table of Hardware also works well as a learning platform, as long as you confirm the hardware revision before you buy.

What do you need before you start?

Equipment

  • A computer with an Ethernet port, or a USB-to-Ethernet adapter
  • An Ethernet cable
  • Your router, plugged in and powered on, with your stock admin password at hand
  • The correct OpenWrt "factory" image for your exact model and hardware revision (covered in the first installation step below)
  • A copy of your router's current stock firmware file, downloaded from the manufacturer's support site, in case you want to revert later

Does installing OpenWrt void your warranty?

Many router warranties say that installing third-party firmware voids coverage, but in the United States that blanket statement is weaker than it sounds. The Magnuson-Moss Warranty Act bars a manufacturer from voiding a warranty simply because you used third-party parts, software, or service; it can only deny coverage for a defect it can show was caused by the modification. The FTC has sent warning letters and brought cases against companies using "warranty void" language of this kind.

In practice, expect pushback if you send in a router running OpenWrt. If the router is still under warranty and you want to avoid the argument, flash the stock firmware back before making a claim, or use a second router for OpenWrt.

What are the risks?

The two ways to brick a router are flashing the wrong file and losing power or the connection mid-flash. Both are avoidable: match the image to your exact hardware revision, use a wired connection, and leave the router alone until it reboots on its own. Most supported devices also have a failsafe or TFTP recovery mode documented on their wiki page, but recovery is not guaranteed, so proceed only if you accept that possibility.

How do you install OpenWrt?

The steps below cover the standard web-upload method, which applies to most TP-Link, Netgear, Linksys, ASUS, and GL.iNet routers. If your device page on the Table of Hardware describes a different method, follow the device page.

Download the correct firmware image

Go to the OpenWrt Firmware Selector, type your router model, and pick the entry that matches your hardware revision. Leave the version set to the latest 25.12 release. Do not choose a "SNAPSHOT" build: snapshots are development builds that change daily and ship without the LuCI web interface.

Download the file labeled Factory. This is the image designed to be accepted by your router's stock firmware. The Sysupgrade file is for routers that already run OpenWrt, and your stock firmware will usually reject it. If the selector shows only a sysupgrade file for your device, check the Table of Hardware page; some devices use a single image for both purposes.

Save the file where you can find it and do not rename it. Some stock firmware checks the file name.

Connect your computer to the router by Ethernet

Plug the Ethernet cable into one of the router's LAN ports, not the WAN or Internet port, and into your computer. Turn off Wi-Fi on the computer so all traffic goes over the cable. A wireless connection can drop during the flash, which is one of the main causes of a bricked router.

Log in to the stock admin panel

Open a browser and enter your router's address. Common defaults are 192.168.1.1, 192.168.0.1, and 10.0.0.1; TP-Link and Netgear routers also answer at tplinkwifi.net and routerlogin.net. If none of those work, our guide to finding your router's IP address shows how to look it up, and the router login guide covers default credentials by brand.

Find the firmware upgrade page

The location varies by brand:

  • TP-Link: Advanced > System Tools > Firmware Upgrade (older models: System Tools > Firmware Upgrade)
  • Netgear: Advanced > Administration > Firmware Update (or Router Update)
  • Linksys: Connectivity > Router Firmware Update > Manual (older models: Administration > Firmware Upgrade)
  • ASUS: Administration > Firmware Upgrade
  • GL.iNet: System > Upgrade > Local Upgrade

If your interface does not match, look for any menu item containing "firmware," "update," or "upgrade." Turn off any option to keep or preserve settings, since stock settings are not compatible with OpenWrt.

Flash the OpenWrt image

Use the browse or choose-file button to select the factory image you downloaded, then start the upgrade. Do not unplug the router, close the browser, or disconnect the cable until it finishes. The flash takes two to five minutes, and the router reboots on its own. Lights may blink, go dark briefly, or change pattern during the process. That is normal.

Log in to OpenWrt (LuCI)

Wait at least three minutes after the reboot, then open a browser and go to http://192.168.1.1. You should see the OpenWrt LuCI login page. The default username is root with no password.

If the page does not load, your computer may still hold an IP address from the old network. On Windows, open Command Prompt and run ipconfig /release then ipconfig /renew. On macOS, go to System Settings > Network, select the Ethernet connection, and click Renew DHCP Lease. Unplugging and replugging the Ethernet cable also works.

Set a root password right away

Go to System > Administration > Router Password and set a strong password. Until you do, anyone who can reach the router's LAN can log in as root. This also protects SSH, which is enabled by default on the LAN side.

One more monthly fee to kill

Renting your modem? That's $120+ a year.

Own it instead. It pays for itself in months. 90-day warranty and 30-day returns.

Pick your provider:

What should you set up right after installing?

How do you get the internet connection working?

Plug your modem's Ethernet cable into the router's WAN port. Go to Network > Interfaces in LuCI. The WAN interface defaults to DHCP client, which works for nearly all cable connections and most fiber connections. If your ISP uses PPPoE (common with DSL and some fiber providers), click Edit on the WAN interface, change the protocol to PPPoE, and enter the username and password your ISP gave you. If your modem was previously paired with a different router, power-cycle the modem so it picks up the new router's MAC address.

How do you turn on Wi-Fi?

OpenWrt ships with Wi-Fi disabled so the router is never broadcasting an open network. To enable it:

  1. Go to Network > Wireless. You will see one entry per radio (2.4 GHz and 5 GHz on most routers, plus 6 GHz on Wi-Fi 6E and 7 models).
  2. Click Edit on the first radio.
  3. Under Interface Configuration > General Setup, enter your network name (ESSID) and confirm the network is attached to lan.
  4. On the Wireless Security tab, choose WPA2-PSK/WPA3-SAE Mixed Mode and enter a strong passphrase. Mixed mode is the safer choice in 25.12 because some clients, including Pixel 10 phones, have trouble joining WPA3-only Wi-Fi 6 networks, and 802.11r fast roaming has known issues with WPA3 enabled.
  5. Click Save & Apply, then repeat for each radio. You can use the same name and passphrase on every band.
  6. Back on the Wireless overview, click Enable for each radio if it is still shown as disabled.

Country code matters: set it under Advanced Settings on each radio so the router uses the correct channels and power limits for your region.

How do you keep OpenWrt updated?

OpenWrt 25.12 uses the apk package manager, and the LuCI software page works the same way it always has: go to System > Software and click Update lists to refresh the package index. From the command line over SSH, the equivalent is apk update. Package names are the same as before; only the commands changed.

For version upgrades, 25.12 includes Attended Sysupgrade by default. Go to System > Attended Sysupgrade, click Search for firmware upgrade, and the service builds an image that includes every package you have installed, then flashes it while keeping your settings. This replaces the old routine of flashing a generic sysupgrade file and reinstalling packages by hand.

What else is worth adding?

  • DNS-level ad blocking: Install adblock-fast and luci-app-adblock-fast from System > Software, then enable a blocklist. Every device on the network benefits.
  • Encrypted DNS: The https-dns-proxy package sends DNS queries over HTTPS to a resolver you choose, which stops your ISP from reading them. Our router DNS guide compares resolvers.
  • WireGuard VPN: Install luci-proto-wireguard and import a configuration from Proton VPN or Mullvad to route the whole network through the tunnel. See our whole-home VPN guide.
  • Guest or IoT network: Create a second wireless network attached to a new interface and firewall zone that can reach the internet but not your main LAN. This keeps cameras and smart plugs away from your computers.

How do you fix common installation problems?

The router rejects the firmware file

This almost always means the wrong image. Confirm you downloaded the factory image, not sysupgrade, and that it matches your exact hardware revision. Some stock firmware also refuses files above a size limit or requires a specific extension; the Table of Hardware page for your device lists any such quirks, including whether you need to downgrade stock firmware first.

You cannot reach 192.168.1.1 after flashing

Wait a full five minutes, since the first boot takes longer than later ones. Confirm the cable is in a LAN port, then release and renew your computer's IP address as described above. If that fails, set a static IP on the computer of 192.168.1.2, subnet mask 255.255.255.0, gateway 192.168.1.1, and try again.

The router appears bricked

Most supported routers have a failsafe mode or a TFTP recovery mode built into the bootloader. Open your device's page on the OpenWrt wiki and look for the Recovery or Debricking section. The usual pattern is to hold the reset button while powering on, then push a firmware file to the router with a TFTP client at a fixed address.

Wi-Fi does not appear

This is expected. Wi-Fi is disabled until you enable each radio under Network > Wireless. Follow the Wi-Fi steps above.

Wired devices get online but Wi-Fi devices do not

The wireless network is probably not attached to the LAN. Go to Network > Wireless, click Edit on the network, and under General Setup make sure Network is set to lan. If devices connect but have no internet, also check that the WAN interface shows an IP address under Network > Interfaces.

Should you install OpenWrt?

Yes, if your router is on the Table of Hardware and you want ongoing security updates, a router-level VPN, network-wide ad blocking, or isolated networks for smart home devices. It is especially worthwhile on a router that works well but has stopped receiving manufacturer updates, which is the point where the usual replace-your-router advice would otherwise apply.

Skip it if your router is not supported, if it is an ISP-supplied gateway, or if you need manufacturer features such as a vendor app or cloud-managed mesh that OpenWrt does not replicate. If you prefer a different open-source firmware, we also have guides to installing DD-WRT and installing FreshTomato.

Frequently Asked Questions

What routers are compatible with OpenWrt?

More than 2,200 devices are supported as of OpenWrt 25.12, including many TP-Link Archer, Netgear Nighthawk, Linksys, ASUS, GL.iNet, Xiaomi, and Cudy models. The Table of Hardware is the only authoritative list, and support depends on the exact hardware revision printed on the router's label.

Which OpenWrt version should I install in 2026?

Install the latest 25.12 release, which was 25.12.6 as of November 2026. The 24.10 series reached end of life six months after 25.12 shipped and no longer receives security updates. Avoid snapshot builds unless a developer asks you to test one.

Can OpenWrt brick my router?

Yes, if you flash the wrong image, flash an unsupported device, or lose power or the connection during the flash. When you match the factory image to your exact hardware revision and use a wired connection, the risk is low, and most supported routers have a documented recovery mode.

What is the difference between the factory image and the sysupgrade image?

The factory image is formatted so your router's stock firmware will accept it, and it is the file you use for the first install. The sysupgrade image is for updating a router that already runs OpenWrt. Using a factory image on a router already running OpenWrt, or a sysupgrade image on stock firmware, can fail or brick the device.

Does installing OpenWrt void my warranty?

Not automatically in the United States. Under the Magnuson-Moss Warranty Act, a manufacturer can deny coverage for damage it can show was caused by third-party software, but it cannot void the whole warranty because you installed it. Many warranties still include that language, so expect a dispute. Flashing stock firmware back before a claim avoids the issue.

Can I go back to the original firmware?

Usually, yes. On many routers you can upload the manufacturer's stock firmware file through LuCI at System > Backup / Flash Firmware, though some devices need a stripped version of the stock file or a TFTP recovery flash. Your device's wiki page has the exact steps. Download the stock firmware before you install OpenWrt so you have it on hand.

Is OpenWrt safe and secure?

OpenWrt is widely considered more secure than typical stock firmware because it receives frequent security updates, its code is publicly auditable, and it ships with Wi-Fi off and no services exposed to the internet. Security still depends on you: set a root password, keep the firmware updated through Attended Sysupgrade, and do not open the admin interface to the WAN side.

Can I install OpenWrt on a modem-router combo from my ISP?

Almost never. ISP gateways are locked to the provider's firmware. The reliable approach is a separate modem you own paired with a supported router running OpenWrt, which also lets you drop the equipment rental fee. Our modems by provider collection lists compatible modems for each ISP.

USA-Based Modem & Router Technical Support Expert

Our entirely USA-based team of technicians each have over a decade of experience in assisting with installing modems and routers. We are so excited that you chose us to help you stop paying equipment rental fees to the mega-corporations that supply us with internet service.

Updated on

Leave a comment

Please note, comments need to be approved before they are published.