RecoveryGateway

Compatibility

Hardware

ItemRequirement
ChipESP32-S3 (other ESP32 families are not supported)
MemoryAt least 8 MB quad flash and 8 MB octal PSRAM: N8R8 and N16R8 modules (N16R8 tested). Not 4 MB flash, R2 or no PSRAM, or octal-flash modules — see Hardware
Wi-Fi2.4 GHz network, WPA2/WPA3 Personal or WPA2-Enterprise (PEAP/TTLS)
USBNative USB or a USB-to-UART chip, with a data cable
USB uplinksFrom 3.0.25, one USB modem, 4G stick, USB Ethernet adapter or phone on the board's USB port, with its own 5 V supply; experimental, not yet tested with real devices — see USB devices
EthernetOptional W5500 SPI module, driver in the standard image, off until configured; experimental, not hardware-qualified

Tailnet

Tailscale (hosted) and self-hosted Headscale. Version and policy compatibility follow the documented subset; see the Headscale guide. This is community firmware, not an official Tailscale client.

Installing

Browser installer: desktop Chrome or Edge (Web Serial). Easy Install package: Windows 10/11, macOS and Linux with Python 3 and esptool 5.

Known limits

Support Mattboxx Edition

Enjoying the gateway? Choose where to leave a tip or support its development.

GitHub SponsorsSupport via GitHub Ko-fiLeave a tip on Ko-fi

Entirely optional. The firmware and all features stay free. Payments are handled on your chosen provider's website.