Repository navigation
Contributing and Credits
mattbox03 edited this page Oct 23, 2026
·
1 revision
- Questions and ideas: Discussions.
- Bugs, hardware reports, guide feedback: open an issue with the firmware version and a sanitized export (Devices & Recovery).
-
Code and docs: read
CONTRIBUTING.md
and the code of conduct.
Build with PlatformIO, ESP-IDF 5.5.3, environment
esp32-s3;python tools/validate_all.pyruns the offline test campaign. - Security issues: report privately, see Security Model.
Never post or commit passwords, auth keys, configuration backups, NVS dumps, real addresses or tailnet names.
This edition is built on the work of others; their copyright, licenses and notices are preserved in the source and in every download package.
- esp32-tailscale-subnet-router by Csontikka (upstream base v0.1.38): Tailscale stack integration, AP router, subnet routing, firewall and Web UI foundation.
- MicroLink by Csontikka, originally based on CamM2325's work: the embedded Tailscale/WireGuard client.
- Tailscale, WireGuard, DERP and Headscale are the work of their respective projects; ESP-IDF and lwIP (including the mDNS responder) come from Espressif and the lwIP project.
Tailscale is a trademark of Tailscale Inc. This project is not affiliated with Tailscale Inc., the Headscale project or Espressif.
License: MIT · NOTICE · Cite this project
Start
Roles
- Service Gateway
- Subnet Router
- Exit Node
- Headscale
- Recovery and Wake-on-LAN
- Monitoring and Health
- Integrations
Operate
Reference
Project