Raspberry Pi + ImmortalWrt

Raspberry Pi ImmortalWrt Docs Hub

From firmware flashing and network onboarding to OpenClash and backup/restore, organized around real deployment scenarios.

ImmortalWrt 24.10.3Raspberry Pi 4B/400/CM4MIT LicenseActively Maintained
Read English Overview查看中文
  • Covers the full path from flashing to network and plugin setup.
  • Includes backup, restore, maintenance, and troubleshooting workflows.
  • Chinese and English views are separated for clean reading.
Browser language auto-detectionFrontend and Markdown stay in syncBeginner-friendly and step-by-step

Guides

9

Flashing, network, maintenance, and expansion

Scripts

1

Automation and backup tooling docs

Changelog Items

3

Tracks docs/scripts/frontend updates

Firmware Version Description

ImmortalWrt-Raspberry Pi 4B/400/CM4 (64bit) Latest

Open Releases

EXT4 Version

Complete installation that erases existing configurations. Best for first-time installation or full reset. Supports larger storage and better recovery, but requires reconfiguration after flashing.

SQUASHFS Version

Incremental update that keeps user configurations. Ideal for users who only need firmware upgrades. Smaller footprint and faster boot, but limited writable storage.

Document Catalog

Browse by category and open the full document with one click.

Getting Started

Project overview and firmware flashing

2 docs

Network and Proxy

LAN/PPPoE setup and OpenClash configuration

3 docs
  • LAN Connection (Upstream Router LAN Uplink)

    This guide is for the common setup where your Raspberry Pi running ImmortalWrt gets internet from an upstream router, and devices connected to the Pi Wi-Fi can also access the internet.

    docs/en/Lan_Connectioin.md
  • OpenClash Network Access Configuration

    For specific configuration details, please refer to the YouTube video in the README documentation. When the author has time, a pre-configured firmware will be released directly.

    docs/en/Openclash_Config.md
  • PPPoE Dial-up Connection Solution

    For home dial-up, the software router acts as the main router. Related dial-up account acquisition is not covered here. Please see Bridging Mode Tutorial.

    docs/en/PPPoE_Connection.md

Backup and Maintenance

Backup strategy, restore flow, and maintenance

4 docs
  • Safe Expansion of ImmortalWrt TF Card System

    Below is the most concise, complete, and pitfall-free expansion tutorial , including all commands from partitioning, formatting, mounting to verification.

    docs/en/ExtendOverlaySize.md
  • 🌐 ImmortalWrt → Smart Automatic Backup

    Script : /root/smart backup.sh

    docs/en/OpenWrt_AutoBackup.md
  • Backup and Restore

    Since the author's SD card is 128GB, all mounted to the OpenWrt system, but the entire system only consumes 287MB of resources, which is a bit overkill. Therefore, the plan is to backup and switch to a 4GB memory card.

    docs/en/OpenWrt_Backup&Resotre.md
  • OpenWrt System Maintenance and Troubleshooting

    Document Scope : Daily maintenance, monitoring setup, and troubleshooting practices for Raspberry Pi + ImmortalWrt.

    docs/en/System_Maintenance.md

Scripts and Updates

Script usage and changelog index

2 docs