Network role
Raspberry Pi ImmortalWrt documentation
A complete reference for first-time ImmortalWrt setup, covering firmware flashing, network access, OpenClash, backups, and routine maintenance. Each phase includes prerequisites, procedures, and acceptance checks.
Devices: Raspberry Pi 4B / 400 / CM4; covers OpenWrt 24.10 and 25.12 or newer
Documentation coverage
Use cases
First installation
Network configuration
Proxy configuration
Configuration sequence
Confirm the hardware target, network role, and configuration sequence.
Acceptance check · The applicable network plan is selectedChoose the correct target and filesystem, write the image safely, and complete first boot.
Acceptance check · The LuCI interface opensKeep the existing router upstream and let the Pi obtain internet access over Ethernet.
Acceptance check · Pi Wi-Fi clients can reach the internetIdentify opkg or apk first, then import a template, add your subscription, and verify routing.
Acceptance check · Proxy and direct rules workExport and verify a configuration backup, then record the firmware release and packages that require separate installation.
Acceptance check · A usable configuration backup is storedEstablish health checks, log review, and a recurring maintenance process.
Acceptance check · A routine maintenance checklist is availablePreparation
Network role
System branch
Filesystem
Technical guides
Uplink, dial-up, and connectivity
Use this path when an existing router already handles the internet connection. The Pi connects to it over Ethernet, while phones and computers join Pi Wi-Fi and pass through the Pi for OpenClash routing.
This guide is for two common cases:
OpenClash at that time:
Proxy, storage, and advanced configuration
Use this guide after the base network works with OpenClash disabled . Otherwise, complete the base-network checks first.
This guide answers the three questions that usually get mixed together:
This guide only applies when:
Recovery, monitoring, and maintenance
An OpenWrt configuration archive is not a full disk image. It primarily saves files such as /etc/config; it does not automatically reinstall every third-party package and kernel module.
Document Scope : Daily maintenance, monitoring setup, and troubleshooting practices for Raspberry Pi + ImmortalWrt.
Note: this page is kept as a legacy reference for the older SSH + configs/ snapshot workflow.
Scripts, conventions, and release notes
This page is not a user tutorial.
This script set provides a stable daily backup workflow for ImmortalWrt routers:
This directory records major project updates and maintenance history.
PROJECT SUPPORT