An unofficial Tailscale client for the Miyoo Mini Plus, which also works with your own Headscale server, a plain WireGuard server, or NetBird. It puts the device on your network, so the other MiniDeck apps (and your own) can reach the servers on it. Part of MiniDeck.
- Log in by scanning a QR code with your phone; connects by itself at boot.
- Devices with their addresses, connection type and ping; exit nodes; subnet routes; Tailscale DNS and SSH; shields up; several accounts.
- Taildrop: files sent to the Miyoo land in
Media/Taildrop. - A status icon in the Onion menu, for Tailscale, WireGuard and NetBird.
- Headscale (or another Tailscale-compatible server) logs in with the same QR code. WireGuard (from a
.conffile) and NetBird (cloud or self-hosted) stay off until you pick them in Settings > Network. - Tailscale 1.104.6 built from source down to 18.9 MB. Its state, like the WireGuard config and the NetBird login, is kept on the card only encrypted, with a key in the device's own flash.
Open MiniMart and pick Apps > MiniScale: it checks the download and keeps your settings on updates. Or unzip miniscale-VERSION.zip from Releases onto the root of the SD card and restart. Every MiniDeck app comes in one zip too: minideck-all.zip.
Needs a Miyoo Mini Plus on Onion OS 4.4, with Wi-Fi, and a Tailscale account, a Headscale server, a WireGuard server or a NetBird account. Other devices and firmwares aren't supported.
Open Apps > MiniScale and press A.
- L1/R1 switch between Devices, Exit node, Settings and Account; L2/R2 jump to the top and the bottom of the list.
- A opens a device, picks an exit node or changes a setting; on a device, X pings it and Y uses it as the exit node. A on this Miyoo's own row shows its addresses and the full name other devices reach it by.
- X connects and disconnects; Y on the Account tab removes another account.
- SELECT changes the look. If Tailscale stops answering, A restarts it.
The device has no TUN interface, so Tailscale runs in userspace mode and other programs reach the network through its SOCKS5 proxy (127.0.0.1:1055) or HTTP proxy (127.0.0.1:1056), as the MiniDeck apps do. For apps that can't use a proxy, list port forwards in App/MiniScale/forwards.conf:
8096 homeserver:8096 # Jellyfin
Settings that apply before the first login (the device name, Tailscale SSH, the proxy ports) are in App/MiniScale/miniscale.conf. With MiniScale on, the CLI is /tmp/miniscale/tailscale --socket=/tmp/miniscale/tailscaled.sock.
Headscale
When you log in or add an account, pick Your own server and type its address (for example hs.example.com). The QR code then opens your server's login page; with Headscale, approve the device there or with headscale nodes register. Each account remembers its server, and the Account tab shows it.
WireGuard
For a plain WireGuard server (a router, wg-easy, a VPS), MiniScale runs WireGuard in userspace behind the same proxies, so the other apps work unchanged.
- Make a config for the Miyoo on your server (the usual
wg-quick.confwith an[Interface]and a[Peer]). - Copy it to the top of the SD card or to
App/MiniScale, or send it with Taildrop. - In MiniScale, choose Settings > Network (or Y while MiniScale is off), pick WireGuard, then Import a config, and connect.
MiniScale keeps the config encrypted and offers to remove the plain file, which holds the private key. Connections to the addresses in a peer's AllowedIPs go through WireGuard and the rest go out directly, so a full-tunnel config (0.0.0.0/0) sends everything through your server, names looked up included. Only TCP goes through the proxies. Switch network on the WireGuard screen goes back; every login stays saved.
NetBird
NetBird's own client is included, built from source. Choose Settings > Network > NetBird, turn it on, then log in to NetBird's cloud or your own server, with a QR code on your phone or a setup key from the dashboard.
- NetBird uses about twice Tailscale's memory: close big apps if the Miyoo slows down.
- Reach your NetBird devices by their addresses (100.x.y.z): NetBird's proxy looks names up with the Miyoo's own DNS, so NetBird names don't resolve through it.
- Only TCP goes through the proxies, and NetBird's routes to other networks and exit nodes aren't available in this mode.
While WireGuard or NetBird runs, MiniScale lists what goes through its proxy in /tmp/miniscale/routes, and the MiniDeck apps (from MiniDeck 1.1) send those addresses through it.
make check # vet, tests, scripts
make package VERSION=1.0.0 # dist/: the release zip, app.json, SHA256SUMS
make deploy HOST=root@miyoo # build and copy to a device over SSHGo runs in Docker unless you pass GO=go (Go 1.27). The interface, themes and networking come from the MiniDeck library; see its development notes and contributing guide.
MIT. Third-party components are listed in NOTICE. MiniScale is not made or supported by Tailscale Inc. or NetBird GmbH, or affiliated with Miyoo. WireGuard is a registered trademark of Jason A. Donenfeld.