Start here → docs/USG-PRO-4.md
This repository is a GitHub-maintained OpenWrt tree
for the Ubiquiti UniFi Security Gateway Pro 4
(ubnt,usg-pro-4 / UBNT_E220 / Cavium CN6120). It is not an official
OpenWrt release and not a generic multi-target build.
SPDX-License-Identifier: MIT (this README and
docs/USG-PRO-4.mdonly — OpenWrt sources remain GPL-2.0-only; see License)
| Piece | Purpose |
|---|---|
| Factory EEPROM MACs | Correct lan1…wan2 addresses on first boot |
kmod-octeon-flowtable |
Clean-room nftables hardware flow offload |
| CI Releases + Pages apk feeds | Flashable lean / router images and matching packages |
| Proton2025 LuCI theme | Submodule for the router image |
Full detail (versioning v25.12-usg.N, testing, signing, apk install):
docs/USG-PRO-4.md.
Agent / branch notes: AGENTS.md.
- Download a Release for your tag (e.g. v25.12-usg.2) — lean (minimal) or router (LuCI + VPN + gateway apps).
- Flash the
*-ubnt_usg-pro-4-squashfs-sysupgrade.tarimage. - Enable
flow_offloading+flow_offloading_hwin firewall defaults;fw4 reload. - Run the WQE↔netdev port-map check once on RJ45 and once on SFP.
- Optional packages: GitHub Pages apk feed.
Branch to use: usg-pro-4/factory-macs (default). Do not merge into
stock OpenWrt main.
- Device support — Shiz/openwrt
(
device/ubnt-e200) - Hardware flow offload — packerlschupfer/octeon-flowtable
- LuCI theme — ChesterGoodiny/luci-theme-proton2025 (Apache-2.0)
The tree retains full OpenWrt history and tracks Codeberg via upstream.
The classic project README (About, download, build requirements, support)
is preserved here: docs/OPENWRT-README.md.
Live upstream copy:
openwrt/openwrt README.
Sunshine!
OpenWrt in this tree remains GPL-2.0-only — see COPYING
and LICENSES/GPL-2.0.
kmod-octeon-flowtable is GPL-2.0 (kernel module), following
packerlschupfer/octeon-flowtable.
Original documentation for this mirror (README.md,
docs/USG-PRO-4.md, AGENTS.md) is
MIT (LICENSES/MIT). MIT does not relicense OpenWrt
or the flowtable driver.