Skip to content

Releases

Firmware v3.0.30 — Restart button after uplink changes

Choose a tag to compare

@Mattboxx Mattboxx released this 19 Nov 22:31
1ee619c

Firmware v3.0.30 — Restart button after uplink changes

Fixed

  • Saving the Ethernet or mobile data (SIM) uplink now shows the Restart
    button
    , like the other settings that apply after a restart. Before, only
    a short note in the card said to restart. The monthly data limit still
    applies at once and does not ask for a restart.
  • System → About shows the RecoveryGateway repository as the source (the
    link already opened it; the text still showed the old name).

Everything of 3.0.29 is included.

Install: web installer, Easy Install package, or OTA (System → Updates).
Verify the files against SHA256SUMS.txt.

Firmware v3.0.29 — USB SIM sticks on the home network, DNS over the SIM

Choose a tag to compare

@Mattboxx Mattboxx released this 19 Nov 16:26
5176f64

Firmware v3.0.29 — USB SIM sticks on the home network, DNS over the SIM

Fixed

  • A USB SIM stick that uses the same addresses as the home network
    (for example 192.168.1.x on both sides, common with router-style sticks
    whose range cannot be changed) no longer cuts the gateway off from the home
    devices. Home addresses go through Wi-Fi or Ethernet; only the stick's own
    addresses, and its gateway while it carries the Internet traffic, go to the
    stick. Diagnostics → Route lookup shows the reason.
  • With mobile data as the main Internet uplink, name lookups use it too.
    Before, the gateway could keep asking the home router's DNS through the
    stick: names did not resolve and Tailscale kept disconnecting and
    reconnecting every few minutes. The home router's DNS comes back when
    Wi-Fi or Ethernet carries the traffic again; a DNS server you chose outside
    the home network (for example 1.1.1.1) is kept.
  • System → Updates links the RecoveryGateway repository and shows the
    release-notes link again for its releases.

Website

  • After a browser install, the install page shows the next step and an
    optional tip button.
  • On phones the top bar stays visible while scrolling, and the open menu no
    longer covers the page.

Everything of 3.0.28 is included.

Install: web installer, Easy Install package, or OTA (System → Updates).
Verify the files against SHA256SUMS.txt.

Firmware v3.0.28 — RecoveryGateway

Choose a tag to compare

@Mattboxx Mattboxx released this 19 Nov 13:21
84284ad

Firmware v3.0.28 — new name: RecoveryGateway

Changed

  • ESP32 Tailnet Gateway is now RecoveryGateway — Mattboxx Edition. Same
    firmware, same settings: nothing to reconfigure. The web interface, Home
    Assistant device, notifications, logo and release files carry the new name.
    A new device's first-boot Wi-Fi is now RecoveryGateway-Setup-XXXX.
  • New addresses: this repository is now Mattboxx/RecoveryGateway and the
    website is https://mattboxx.github.io/RecoveryGateway/. Old website links
    open the same page at the new address.
  • The updater looks for releases here first. Gateways on 3.0.27 or older
    still find this release with Check for updates: the old repository name
    keeps a copy of 3.0.28 for them, and later updates come from here.

Website

  • A "Which board?" button leads to the tested ESP32-S3 boards.

Everything of 3.0.27 is included.

Install: web installer, Easy Install package, or OTA (System → Updates).
Verify the files against SHA256SUMS.txt.

Firmware v3.0.27 — one more case that could block the tunnel is fixed

Choose a tag to compare

@Mattboxx Mattboxx released this 18 Nov 23:13
b85220e

Firmware v3.0.27 — one more case that could block the tunnel is fixed

Fixed

  • A device whose key expiry carries a time zone offset (for example
    "+01:00", possible with some control servers) or a year after 2099 made the
    gateway refuse the whole device list and block the tunnel, like the 64-bit
    ID issue fixed in 3.0.26. These times are now read correctly; malformed
    ones are still refused. The gateway's own key expiry shown on the Tailscale
    page also honours the offset.
  • The user ID of the registration is read exactly (shown in the log).

Everything of 3.0.26 is included: the fix for tailnets with recently added
devices, Headscale with a private CA, first connection without DNS, ACL
"cap:" rules, two relays to other regions, up to 5 devices per LAN → Tailnet
rule and configuration profiles for every first-boot goal.

Install: web installer, Easy Install package, or OTA (System → Updates).
Verify the files against SHA256SUMS.txt.

Firmware v3.0.26 — fix for tunnels blocked by new devices, Headscale with a private CA, profiles for every goal

Choose a tag to compare

@Mattboxx Mattboxx released this 18 Nov 21:16
46d2917

Firmware v3.0.26 — fix for tunnels blocked by new devices, Headscale with a private CA, profiles for every goal

Fixed

  • Tunnel blocked in tailnets with recently added devices. The log showed
    "Authorization/peer update needs a full refresh; tunnel data blocked
    (stage=policy reason=peer-id ...)". Tailscale device IDs are 64-bit numbers;
    devices added recently have IDs larger than the gateway's JSON reader could
    hold exactly, so the gateway refused the whole device list and blocked the
    tunnel. IDs are now read exactly, also in device updates and removals.

Added

  • Headscale with a private CA or a self-signed certificate: a Login
    server certificate
    field on the Tailscale page, trusted only for the login
    server and its relays, from the next restart (the server name is still
    checked; updates, MQTT and notifications keep public certificates only).
  • First connection without working DNS: the Tailscale control server is
    found through a Tailscale relay at a built-in address, as the official
    client does.
  • ACL rules with "cap:" sources admit the devices that hold that
    capability.
  • Two relays to other regions at once for devices without a direct path.
  • LAN → Tailnet: up to 5 allowed devices per rule, and a guide to share
    one of your services with another network: docs/SERVICE-GATEWAY.md.
  • Configuration profiles for every first-boot goal (System → General):
    two new ones (LAN → Tailnet services, Home Assistant), in the setup's
    order, the goals chosen at first boot marked "chosen at setup", guided
    steps for everything added since 3.0. Profiles never open access, change
    routes or send data by themselves.
  • Date and time in the pre-crash log.

Still open: IPv6 inside the tailnet (use a device's 100.x address) and very
large tailnets above about 250-500 devices.

Install: web installer, Easy Install package, or OTA (System → Updates).
Verify the files against SHA256SUMS.txt.

Firmware v3.0.26-beta.2 — fix for tunnels blocked by new devices, Headscale with a private CA

Choose a tag to compare

@Mattboxx Mattboxx released this 18 Nov 19:51

Firmware v3.0.26-beta.2 — fix for tunnels blocked by new devices, Headscale with a private CA, first connection without DNS

Beta for testing. It builds on 3.0.25 (the current stable release) and
extends what the gateway can reach in a tailnet. New behaviour that could
change your setup is off by default or only used when you set it.

Tailnet

  • Fixed: tunnel blocked in tailnets with recently added devices. The log
    showed "Authorization/peer update needs a full refresh; tunnel data blocked
    (stage=policy reason=peer-id ...)". Tailscale device IDs are 64-bit numbers;
    devices added recently have IDs larger than the gateway's JSON reader could
    hold exactly, so the gateway refused the whole device list and blocked the
    tunnel. IDs are now read exactly, also in device updates and removals.
    This affects 3.0.25 and earlier.
  • Headscale with a private CA or a self-signed certificate. The Tailscale
    page has a Login server certificate field: paste the CA (or the server
    certificate) as PEM text. It is trusted only for the login server and its
    relays, from the next restart and only while a login server is set. The
    server name and validity are still checked; firmware updates, MQTT and
    notifications keep using public certificates only. Saving or removing it
    needs the admin password.
  • First connection without working DNS. When the Tailscale control
    server's name cannot be resolved and no working address is known yet, the
    gateway asks a Tailscale relay at a built-in address for it over a verified
    TLS connection, as the official client does. The address is kept in memory
    only, and the server is still verified by its certificate and key.
  • ACL rules with "cap:" sources work. Such a rule now admits the devices
    that hold that capability (from their tailnet addresses), instead of nobody.
  • Two relays to other regions at once. Devices homed on two different
    relay regions, both without a direct path, are reachable at the same time
    (one extra relay before). Each extra relay opens only when needed and closes
    after a minute without traffic.

LAN → Tailnet

  • Up to 5 allowed devices per rule ("192.168.1.20, 192.168.1.30"), next to
    one device or a whole subnet.
  • New guide: share one service with another network. A gateway placed in
    a friend's home, joined to your tailnet with a tagged key, lets a few of
    their devices use one of your services (one address and port) and nothing
    else: your tailnet ACL limits what the gateway reaches, the rule limits who
    may use it. See docs/SERVICE-GATEWAY.md.

Other

  • The pre-crash log shows date and time for the lines of the crashed run
    when that run had the clock; the crash header no longer shows the time twice.
  • The optional UDP helpers of the VPN library call the network stack from its
    own thread, and a full network queue can no longer use up the zero-copy send
    slots.

Still open (docs/TAILNET-ACCESS-AUDIT.md): IPv6 inside the tailnet (use a
device's 100.x address) and very large tailnets above about 250-500 devices.

Install: web installer or OTA (System → Updates with "Include beta /
pre-release updates" on). Verify firmware.bin against SHA256SUMS.txt.

Firmware v3.0.25 — Tailscale access fixes, clearer status, LAN → Tailnet redesign

Choose a tag to compare

@Mattboxx Mattboxx released this 18 Nov 12:43
aee332d

Firmware v3.0.25

Fixed: Tailscale and Headscale access

  • Single-use auth keys no longer take the gateway offline. The default key of the Tailscale admin console is single-use; the gateway presented it again at every reconnect and restart, the control server refused it ("invalid key") and the device stayed offline. The key is now used only to log in, as the official client does.
  • No 16-peer limit. A tailnet with more than 16 other devices (stale ones count) was refused as a whole and every tunnel was blocked. The tailnet size is no longer limited; 20 tunnels are in use at a time and go to the peers that need them.
  • Other cases where the tailnet could not be used: a gateway alone in its tailnet, ACL rules with node capabilities, large ACL policies, peers with more than one advertised subnet, networks that block port 80 (TLS on 443 is used) or NTP (time from the control server), DNS failures, auth keys pasted with spaces, an expired node key, peers homed on another relay region without a direct path, peer key renewal, and a Headscale server that changed its key.
  • WireGuard handshakes and keepalives are sent from the network thread, and a direct path that stopped working is given up after 30 s.
  • Large DNS answers no longer reach access-point clients cut (DNS over TCP and proper truncation).
  • Far fewer flash writes for the peer cache.

Added

  • Clear Tailscale status: why the gateway is not connected (key refused or needed, waiting for approval, key expired), node key expiry with a warning 14 days ahead and renewal with a new auth key, Tailnet Lock with the signing command, messages from the control server, peers and tunnels in use, and why the control server refused a connection.
  • Leave tailnet button: logs out at the control server (as tailscale logout), deletes the auth key and identity, turns Tailscale off.
  • Logs with date and time (live view and microSD files).
  • USB uplinks (experimental, not yet tested with real devices): USB LTE modems and 4G sticks with a SIM, USB Ethernet adapters and phone tethering. Read the connection and power guide in the README or on the website first. Off by default.
  • Monthly mobile data limit, traffic per access-point device, and administration limited to the tailnet and the access point (all off by default).

Changed

  • LAN → Tailnet tab redesigned: each rule has a simple "Stays open" choice (no time limit, 15 minutes … 7 days) applied with Save; clearer field names; one LAN device can be entered as a plain address.
  • Web sessions are bound to the address that logged in; the SNMP community is write-only.
  • The Max peers setting is gone: it no longer limited anything.

Update from System → Firmware. Keep a configuration backup before upgrading. Full list: CHANGELOG.

Firmware v3.0.25-beta.24 — Tailnet access fixes, simpler LAN → Tailnet tab

Choose a tag to compare

@Mattboxx Mattboxx released this 18 Nov 10:02

Firmware v3.0.25-beta.24 — Tailnet access fixes, simpler LAN → Tailnet tab

Beta for testing. It contains the Tailnet fixes found after a user's
report on 3.0.24 (official Tailscale, 18 devices, "invalid key"), a review of
the whole Tailnet path for other cases where access could fail, and a
redesigned LAN → Tailnet tab. USB modems and adapters (since beta.5) are still
untested with real devices; please report your board and device. New
behaviour that could change your setup is off by default.

Tailnet: cases where the gateway could not be used

  • Single-use auth keys no longer take the gateway offline. The default key
    in the Tailscale admin console is single-use; the gateway sent it again at
    every reconnect and restart, the control server refused it, and the device
    stayed offline with "invalid key". The key is now used only to log in, as the
    official client does. A refused key is retried once without it; a device
    deleted in the console stops with "enter a new auth key".
  • No 16-peer limit. A tailnet with more than 16 other devices (stale ones
    count) was refused as a whole and every tunnel was blocked. Maps, policy and
    peer table are sized by the tailnet (host tests with 300 and 2000 peers). 20
    tunnel slots are in use at a time; when they are full, a peer that needs one
    takes the slot of an offline or idle peer, and a peer that reaches out gets
    one at once.
  • A gateway alone in its tailnet (or the first device) works: the first
    map without peers was treated as incomplete and blocked the tunnel.
  • ACL rules with "cap:" sources no longer block all traffic.
  • No limit on ACL rules (was 128 expanded rules); every advertised subnet
    of a peer is reachable
    (was its own address plus one route).
  • Networks that block port 80 use TLS on port 443, as the official client.
  • Networks that block NTP: the clock is taken from the control server.
  • DNS failures: the last working address of the control server is used
    (also for Headscale and HTTPS login servers), and relay nodes are reached by
    the address in the DERP map.
  • Peers homed on another relay region are reachable from the gateway even
    without a direct path: when the home relay reports a peer missing, the
    gateway opens one more relay connection to that peer's region (closed after
    60 s idle), as the official client does.
  • Expired node key: shown with a warning 14 days ahead; entering a valid
    auth key renews it for the same device, without a reset. The expired state
    no longer loops.
  • Peer key renewal applies at once, without a full refresh.
  • Headscale: a server that got a new key is picked up without restarting
    the gateway.
  • Auth keys pasted with spaces or line breaks are accepted; a registered
    gateway starts without a saved auth key.

Easier to understand

  • The Tailscale page says why the gateway is not connected (key refused or
    needed, waiting for approval, key expired), shows Tailnet Lock with the
    command to sign this gateway, messages from the control server, peers and
    tunnels in use, and why the control server refused a connection (client
    version, wrong URL or proxy, access refused, rate limit, server error).
  • LAN → Tailnet tab redesigned. Three steps explain what a rule does. Each
    rule shows on one line whether it has a time limit and when it closes, with
    one choice: "Stays open: No time limit, 15 minutes, 1 hour, 8 hours, 1 day,
    7 days", applied with Save. Before, the timer lived in a separate section,
    and after it had been used once, every new or edited rule silently stopped
    forwarding until confirmed there. A rule closed by its time limit now says
    so. One LAN device can be entered as a plain address.

Other

  • Far fewer flash writes: the peer cache was rewritten (about 7.7 KB) for every
    peer at every reconnect; now only when a peer changes.
  • The control and relay connections accept the protocol upgrade only on a real
    "101" status.

Open limitations are listed in docs/TAILNET-ACCESS-AUDIT.md (very large
tailnets above about 250-500 devices, IPv6 inside the tailnet, private-CA
certificates for HTTPS login servers).

Install: web installer or OTA (System → Updates with "Include beta /
pre-release updates" on). Verify firmware.bin against SHA256SUMS.txt.

Firmware v3.0.25-beta.15 — cleaner boot and log, safer web access, DNS fixes, mobile data limit

Choose a tag to compare

@Mattboxx Mattboxx released this 17 Nov 22:21

Firmware v3.0.25-beta.15 — cleaner boot and log, safer web access, DNS fixes, mobile data limit

Beta for testing. USB modems, sticks, adapters and phones are still not
tested with real devices; please report your board and device (the Network
page shows it as vendor:product). Everything below is off by default unless
it says otherwise.

Changes since beta.13

  • No microSD probe at boot while the SD recorder is off. Boards without a
    card logged three SD errors on every boot. The card is now looked for only
    when the recorder is on, the first time its status is shown, or when you
    enable it (a card inserted later is still found).
  • MQTT waits for a network address before its first connection attempt,
    which always failed at boot with "Host is unreachable". An address on the
    LAN side (for a broker on your local network) or on the Internet uplink
    (also mobile) is enough.
  • Refused web connections are closed silently. With administration
    limited to the tailnet and the access point, every connection to the web
    page from the LAN logged an error ("session creation failed"), so a device
    retrying filled the log. It is now closed at once, without reading the
    request and without a log line; System reports the count as
    admin_refused.

The first two were found in the serial log of the maintainer's gateway while
comparing 3.0.24 with beta.13 (present in both): same speed (page, status,
tailnet and forwarding pings within noise, no packet loss), same free memory,
no crash or restart. The third came from testing the new administration
scope on the same gateway.

Changes since beta.8 (summary of beta.13)

Fixed

  • Large DNS answers no longer reach devices cut. The gateway's DNS relay
    used to pass answers above 1 KB on cut and cache them (present since its
    first version). It now asks resolvers for at most 1 KB, turns a longer
    answer into a proper "truncated" reply, never caches truncated answers, and
    also answers DNS over TCP (answers up to 16 KB), asking the resolver over
    UDP with room for 4 KB first. Note: many home routers answer DNS with at most 512 bytes and refuse
    TCP; with such a router, large answers (long TXT records, some services)
    cannot be resolved by any device, with or without the gateway. Setting a
    resolver that supports TCP in the DNS relay settings solves it.
  • USB network sessions: sending a frame while the USB device was
    unplugged could write into memory already freed. Fixed.
  • PPP over a USB modem no longer blocks the gateway's network core while
    the modem is slow: frames are queued instead of waited for.

Security

  • Web sessions are bound to the device that logged in. The web page uses
    plain HTTP; a session cookie copied off the local network or the access
    point no longer works from another device. Changing network asks for the
    password again.
  • Administration can be limited to the tailnet and the access point
    (System → Access, off by default). While the gateway is not connected to the
    tailnet, the local network keeps access, so you cannot lock yourself out.
  • The SNMP community is no longer shown by the web page or API (an empty
    field keeps the saved one), and the card warns while it is still "public".
  • A security event is recorded when the plain-TCP remote console listens on
    the local network or the access point.

Added

  • Monthly mobile data limit (Network → Cellular uplink): counts mobile
    data, warns at a chosen percentage and at the limit, and can stop using
    mobile data until the next month. The month can start on any day 1–28.
    Nothing is counted or written while it is off.
  • Traffic per access-point device (Network → Clients): what each device
    sent and received through the gateway.
  • Events when mobile data starts or stops carrying the Internet traffic
    (a warning in failover mode, where it means Wi-Fi and Ethernet are down).
  • Signal and operator for Huawei HiLink 4G sticks in USB network mode
    (experimental, not tested with a real stick).
  • DNS diagnostics show queries over TCP and oversized answers.

Changed

  • Health & resources moved to Diagnostics → Hardware.
  • Telegram and ntfy remote commands are laid out the same way, with the
    command reference at the end of each card; command options look inactive
    while commands are off.
  • The settings search finds the new functions, also by synonyms and in every
    language.
  • The DNS cache keeps two entries per slot, so busy names evict each other
    less.

Tested

  • Offline: the full validation campaign (host tests of the actual firmware
    code, browser tests of the web page, build and image provenance).
  • On the maintainer's ESP32-S3 over Tailscale: install with saved settings
    unchanged, the new settings and API fields, the access limit (the local
    address refused while the tailnet address works), DNS answers over UDP and
    TCP (TCP through a resolver that supports it), the web page answering for
    3 minutes. Settings changed for the tests were restored.
  • Not tested: real USB modems, sticks, adapters and phones; HiLink signal.

Install

Use System → Updates with "Include beta / pre-release updates", or
System → Firmware with firmware.bin below. The stable release stays
v3.0.24.

Firmware v3.0.25-beta.13 — safer web access, DNS fixes, mobile data limit

Choose a tag to compare

@Mattboxx Mattboxx released this 17 Nov 17:39

Firmware v3.0.25-beta.13 — safer web access, DNS fixes, mobile data limit

Beta for testing. USB modems, sticks, adapters and phones are still not
tested with real devices; please report your board and device (the Network
page shows it as vendor:product). Everything below is off by default unless
it says otherwise.

Changes since beta.8

Fixed

  • Large DNS answers no longer reach devices cut. The gateway's DNS relay
    used to pass answers above 1 KB on cut and cache them (present since its
    first version). It now asks resolvers for at most 1 KB, turns a longer
    answer into a proper "truncated" reply, never caches truncated answers, and
    also answers DNS over TCP (answers up to 16 KB), asking the resolver over
    UDP with room for 4 KB first. Note: many home routers answer DNS with at most 512 bytes and refuse
    TCP; with such a router, large answers (long TXT records, some services)
    cannot be resolved by any device, with or without the gateway. Setting a
    resolver that supports TCP in the DNS relay settings solves it.
  • USB network sessions: sending a frame while the USB device was
    unplugged could write into memory already freed. Fixed.
  • PPP over a USB modem no longer blocks the gateway's network core while
    the modem is slow: frames are queued instead of waited for.

Security

  • Web sessions are bound to the device that logged in. The web page uses
    plain HTTP; a session cookie copied off the local network or the access
    point no longer works from another device. Changing network asks for the
    password again.
  • Administration can be limited to the tailnet and the access point
    (System → Access, off by default). While the gateway is not connected to the
    tailnet, the local network keeps access, so you cannot lock yourself out.
  • The SNMP community is no longer shown by the web page or API (an empty
    field keeps the saved one), and the card warns while it is still "public".
  • A security event is recorded when the plain-TCP remote console listens on
    the local network or the access point.

Added

  • Monthly mobile data limit (Network → Cellular uplink): counts mobile
    data, warns at a chosen percentage and at the limit, and can stop using
    mobile data until the next month. The month can start on any day 1–28.
    Nothing is counted or written while it is off.
  • Traffic per access-point device (Network → Clients): what each device
    sent and received through the gateway.
  • Events when mobile data starts or stops carrying the Internet traffic
    (a warning in failover mode, where it means Wi-Fi and Ethernet are down).
  • Signal and operator for Huawei HiLink 4G sticks in USB network mode
    (experimental, not tested with a real stick).
  • DNS diagnostics show queries over TCP and oversized answers.

Changed

  • Health & resources moved to Diagnostics → Hardware.
  • Telegram and ntfy remote commands are laid out the same way, with the
    command reference at the end of each card; command options look inactive
    while commands are off.
  • The settings search finds the new functions, also by synonyms and in every
    language.
  • The DNS cache keeps two entries per slot, so busy names evict each other
    less.

Tested

  • Offline: the full validation campaign (host tests of the actual firmware
    code, browser tests of the web page, build and image provenance).
  • On the maintainer's ESP32-S3 over Tailscale: install with saved settings
    unchanged, the new settings and API fields, the access limit (the local
    address refused while the tailnet address works), DNS answers over UDP and
    TCP (TCP through a resolver that supports it), the web page answering for
    3 minutes. Settings changed for the tests were restored.
  • Not tested: real USB modems, sticks, adapters and phones; HiLink signal.

Install

Use System → Updates with "Include beta / pre-release updates", or
System → Firmware with firmware.bin below. The stable release stays
v3.0.24.