Remote access with Tailscale Funnel
Use Tailscale Funnel on your Hermes computer to let a gadget connect from outside your home network, including a phone hotspot. The gadget does not need Tailscale installed.
Funnel makes the gadget endpoint public. Device pairing still controls access to Hermes. Publish only the gadget plugin's port.
Set up the Hermes computer
First connect Hermes and keep its gateway running. Install and sign in to Tailscale on that computer. Your tailnet must allow Funnel; follow any authorization link the command displays.
Find the device URL:
hermes gadget infoNote its port and path. For example,
ws://192.168.1.20:8765/gadgetuses port8765and path/gadget.Publish that port. Replace
8765if your plugin uses another port:tailscale funnel --bg 8765 tailscale funnel statusFunnel prints a public HTTPS address such as
https://your-hostname.tail1234.ts.netand proxies requests to the local gadget port. Check that the target port matcheshermes gadget info.Build the gadget address: change
https://towss://and append the path from step 1:wss://your-hostname.tail1234.ts.net/gadgetKeep a custom path if you configured one. The gadget requires a
ws://orwss://address; it does not convert HTTPS URLs. Do not add the local port8765to the public address.
With --bg, Funnel resumes after a reboot while Tailscale is running. Hermes must also be running. To remove all Funnel configuration on this computer:
tailscale funnel reset
See the Funnel command reference for managing individual published services.
Connect the gadget
Enter the full wss:// address above as the Hermes address in the browser installer's Wi-Fi step, phone setup, or the USB console.
To use a phone hotspot:
- Enable a 2.4 GHz hotspot and leave it running.
- Open Wi-Fi setup on the gadget.
- From a device that can join the gadget's
Hermes-XXXXsetup network, openhttp://192.168.4.1. Enter the hotspot name, password, and the fullwss://Hermes address. - Choose Check connection and save. Keep the hotspot available during the connection check.
If your phone cannot keep its hotspot active while joined to the setup network, use a second phone or computer for setup, or configure the gadget through USB.
To keep Hermes off the internet entirely, the gadget can instead join your tailnet itself; see Reach Hermes over your tailnet. That needs firmware you build with the feature turned on.
The board stores one Wi-Fi network. A successful setup replaces its Wi-Fi credentials; a failed connection check restores the previous settings. Re-enter your home Wi-Fi credentials when you return. The same Funnel address works on both networks, and changing Wi-Fi preserves the gadget's identity and pairing with the same Hermes host.
Verify the connection
Test with the gadget on a network outside your home, such as the hotspot. If it shows a pairing code, run hermes gadget pair on the Hermes computer and approve the matching device. Wait for Ready, then send a message and confirm that Hermes replies.
The plugin serves a WebSocket endpoint, not a website. Opening the bare Funnel URL in a browser can return 404 Not a Hermes gadget endpoint; this does not test pairing or a working gadget connection.
Security and troubleshooting
Funnel terminates TLS on the Hermes computer and forwards traffic to the local service. The endpoint is reachable from the public internet, even by devices outside your tailnet.
Device pairing and the protocol's per-device authentication still apply. If you configured an access token, the gadget also needs that token. See authentication.
For connection errors, check
tailscale funnel status, the local port, thewss://scheme, and the complete path. Confirm that Hermes is running.The gadget checks the server's certificate against the public root certificates built into its firmware. Funnel's certificates come from Let's Encrypt, which the gadget trusts. With another tunnel or reverse proxy, the certificate authority matters: if the serial log shows
No matching trusted root certificate found, list the chain the server sends and check which root it ends at:openssl s_client -connect your-host.example:443 -servername your-host.example -showcertsFirmware 0.2.0 failed on chains whose last certificate is a cross-signature by a root that is no longer bundled, such as Cloudflare tunnels (GTS Root R4 cross-signed by GlobalSign Root CA). Newer firmware accepts them.
A successful phone setup check confirms Wi-Fi connectivity. Ready and a reply confirm the connection to Hermes.
The gadget cannot complete a captive portal login. Use a network that permits its connection, such as a phone hotspot.