ImmortalWrt is a fork of OpenWrt, with more packages ported, more devices supported, better performance, and special optimizations for mainland China users.
Compared the official one, we allow to use hacks or non-upstreamable patches / modifications to achieve our purpose. Source from anywhere.
Default login address: http://192.168.1.1 or http://immortalwrt.lan, username: root, password: none.
To build your own firmware you need a GNU/Linux, BSD or MacOSX system (case sensitive filesystem required). Cygwin is unsupported because of the lack of a case sensitive file system.
To build with this project, Ubuntu 20.04 LTS is preferred. And you need use the CPU based on AMD64 architecture, with at least 4GB RAM and 25 GB available disk space. Make sure the Internet is accessible.
The following tools are needed to compile ImmortalWrt, the package names vary between distributions.
Here is an example for Ubuntu users:
Method 1:
sudo bash -c 'bash <(curl -sL https://build-scripts.immortalwrt.eu.org/init_build_environment.sh)'
Note:
For more details, please see Build system setup documentation.
Run git clone --depth=1 https://github.com/hanwckf/immortalwrt-mt798x.git
to clone the source code.
Run cd immortalwrt-mt798x
to enter source directory.
Run ./scripts/feeds update -a
to obtain all the latest package definitions defined in feeds.conf / feeds.conf.default
Run ./scripts/feeds install -a
to install symlinks for all obtained packages into package/feeds/
Copy the configuration file for your device from the defconfig
directory to the project root directory and rename it .config
# MT7981
cp -f defconfig/mt7981-ax3000.config .config
# MT7986
cp -f defconfig/mt7986-ax6000.config .config
# MT7986 256M Low Memory
cp -f defconfig/mt7986-ax6000-256m.config .config
Run make menuconfig
to select your preferred configuration for the toolchain, target system & firmware packages.
Run make -j$(nproc)
to build your firmware. This will download all sources, build the cross-compile toolchain and then cross-compile the GNU/Linux kernel & all chosen applications for your target system.
The main repository uses multiple sub-repositories to manage packages of different categories. All packages are installed via the ImmortalWrt package manager called opkg. If you're looking to develop the web interface or port packages to ImmortalWrt, please find the fitting repository below.
For a list of supported devices see the OpenWrt Hardware Database
ImmortalWrt is licensed under GPL-2.0-only.