asuswrt-merlin.ng/README.md
2025-02-05 22:54:58 +01:00

119 lines
6.7 KiB
Markdown

<p align="center">
<img src="http://nw-dlcdnet.asus.com/plugin/productIcons/DSL-AX82U.png" alt="logo" width="200" height="150">
</p>
<h3 align="center">
<a href="https://github.com/RMerl/asuswrt-merlin/wiki/About-Asuswrt">AsusWrt Merlin</a>
GNUton's builds
</h3>
<p align="center">
A powerful third-party firmware designed for Asus routers.
<br>
<a href="https://github.com/RMerl/asuswrt-merlin.ng/wiki/About-Asuswrt"><strong>Explore Asus Merlin docs»</strong></a>
<br>
<br>
<a href="https://github.com/gnuton/asuswrt-merlin.ng/releases/latest">Download latest firmware</a>
·
<a href="https://github.com/gnuton/asuswrt-merlin.ng/issues/new?assignees=&labels=enhancement&template=feature_request.md">Request feature</a>
·
<a href="https://github.com/gnuton/asuswrt-merlin.ng/issues/new?assignees=&labels=bug&template=bug_report.md">Report bug</a>
</p>
<p align="center">
<a href="https://www.snbforums.com/threads/gnutons-merlin-builds-for-dsl-router-386-1_2-released.70980/">Support forum</a>
·
<a href="https://retro.pizza/@gnuton">@Mastodon</a>
·
<a href="https://discord.gg/pm7q6KFSzp">Chat</a>
·
<a href="https://gitter.im/asuswrt/merlin-dsl">Old Chat</a>
</p>
---------------------
### Aim
This is an official [Merlin fork](https://github.com/RMerl/asuswrt-merlin.ng) which is supported by [ASUS](https://twitter.com/ASUS) and [RMerlin](https://twitter.com/RMerlinDev?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Eauthor): Aim of this project is to make Merlin running on additional routers.
My builds are intended to support all features present in the original Merlin firmware. Occasionally, I also incorporate additional features for specific models. The images are built in the cloud to ensure transparency, and the open-source code is publicly accessible in this GitHub repository.
If you enjoy this project feel free to scroll all the way down and check on how you can ❤️ this project!
---------------------
### ⬇️ Firmware downloads
3006.102.x firmware downloads: latest [testing](https://github.com/gnuton/asuswrt-merlin.ng/releases/tag/3006.102.3_1-gnuton0_beta1)
* [GT-BE98/GT-BE2500](https://rog.asus.com/networking/rog-rapture-gt-be98-model)
3004.388.x firmware downloads: [stable](https://github.com/gnuton/asuswrt-merlin.ng/releases/latest)
* [DSL-AX82U/DSL-AX5400](https://www.asus.com/Networking-IoT-Servers/WiFi-6/All-series/DSL-AX82U/)
* [RT-AX82U v1](https://www.asus.com/Networking-IoT-Servers/WiFi-6/All-series/RT-AX82U/)
* [RT-AX82U v2](https://www.asus.com/Networking-IoT-Servers/WiFi-6/All-series/RT-AX82U/)
* [RT-AX92U](https://www.asus.com/Networking-IoT-Servers/WiFi-Routers/ASUS-Gaming-Routers/RT-AX92U/)
* [TUF-AX5400 v1](https://www.asus.com/Networking-IoT-Servers/WiFi-Routers/ASUS-Gaming-Routers/TUF-Gaming-AX5400/)
* [TUF-AX3000 v1](https://www.asus.com/Networking-IoT-Servers/WiFi-Routers/ASUS-Gaming-Routers/TUF-Gaming-AX3000/)
* [TUF-AX3000 v2](https://www.asus.com/networking-iot-servers/wifi-routers/asus-gaming-routers/tuf-gaming-ax3000-v2/) - 🔥 [New](https://github.com/gnuton/asuswrt-merlin.ng/issues/529)!
* [RT-AX58U v2](https://uk.store.asus.com/rt-ac58u-v2-122214131-90ig06q0-mu9b00.html) - 🔥 [New](https://github.com/gnuton/asuswrt-merlin.ng/issues/550)!
* [ZenWiFi XT8 / RT-AX95Q v1](https://www.asus.com/Networking-IoT-Servers/Whole-Home-Mesh-WiFi-System/ZenWiFi-WiFi-Systems/ASUS-ZenWiFi-AX-XT8/)
* [ZenWifi ET8 / RT-AXE95Q](https://www.asus.com/networking-iot-servers/whole-home-mesh-wifi-system/zenwifi-wifi-systems/asus-zenwifi-et8/)
386.x firmware downloads: [stable](https://github.com/gnuton/asuswrt-merlin.ng/releases/tag/386.12_0-gnuton1) or [testing](https://github.com/gnuton/asuswrt-merlin.ng/releases/tag/386.14_0-gnuton0_beta1)
* [DSL-AC68U](https://www.asus.com/Networking-IoT-Servers/Modem-Routers/All-series/DSLAC68U/)
If you cannot find your router in the above list, please read [🔥 here 🔥](https://github.com/gnuton/asuswrt-merlin.ng/issues/523)!
Not sure which version you have? V1? V2? Enable SSH, then ssh into your router and run ```nvram get productid```
---------------------
### Experimental builds:
* DSL-AC68U & DSL-AX82U
* [Repeater Mode](https://github.com/gnuton/asuswrt-merlin.ng/releases/tag/gnuton-snapshot-feature-repeater) Unleash Repeater along with all other [operational modes](https://www.asus.com/support/FAQ/1015007/). Please note that AiMesh is supported by standard images and it's much performant than repeater but it works only with other Asus routers.
---------------------
### [Stats](https://somsubhra.github.io/github-release-stats/?username=gnuton&repository=asuswrt-merlin.ng)
Latest release:
[
![GitHub release](https://img.shields.io/github/release/gnuton/asuswrt-merlin.ng.svg)
![GitHub Release Date](https://img.shields.io/github/release-date/gnuton/asuswrt-merlin.ng.svg)
![GitHub Releases](https://img.shields.io/github/downloads/gnuton/asuswrt-merlin.ng/latest/total.svg)
](https://github.com/gnuton/asuswrt-merlin.ng/releases/latest)
Latest pre-release:
[
![GitHub tag (latest SemVer pre-release)](https://img.shields.io/github/v/release/gnuton/asuswrt-merlin.ng?include_prereleases&label=pre-release)
![GitHub (Pre-)Release Date](https://img.shields.io/github/release-date-pre/gnuton/asuswrt-merlin.ng)
![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/downloads-pre/gnuton/asuswrt-merlin.ng/latest/total)
](https://github.com/gnuton/asuswrt-merlin.ng/releases/)
All releases:
![GitHub All Releases](https://img.shields.io/github/downloads/gnuton/asuswrt-merlin.ng/total.svg)
Latest Merlin firmware version: ![GitHub release](https://img.shields.io/github/tag/RMerl/asuswrt-merlin.ng.svg)
---------------------
### Thanks to
- Asus for the GPLs and HW samples.
- Upstream Asus Merlin [devs](https://github.com/RMerl/asuswrt-merlin.ng/graphs/contributors)
- GitHub for providing the runners to build new images.
- [CircleCI](https://circleci.com/) for having provided a powerful CI infra for building the images on the cloud.
---------------------
### How can I help?
Do you love this project? All kinds of contributions are welcome 🙌!
* ⭐️ star the project
* raise 🐞 issues
* send 🙇 code. ([Are you a dev? Click here!](https://github.com/gnuton/asuswrt-merlin.ng/blob/master/www/DEV.md))
* Help other people in the community via [chat](https://discord.com/channels/1155054060848807976/1168099691477614642) or [support tickets](https://github.com/gnuton/asuswrt-merlin.ng/issues?q=is%3Aissue+is%3Aopen+label%3Asuppport)
* 💰 donations.
<p align="center">
<a href="https://www.paypal.me/gnuton"><img src="www/donate.png" alt="donate" /></a>
<br/>
or
<br/>
₿itcoin: 3GMqBLaLvH4c6d1bNd35NDjiqDv4pApKpi
</p>