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, and it works like the Tailscale apps on a phone. 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.
- Other networks: log in to Headscale (or another Tailscale-compatible server) with the same QR code, connect to a plain WireGuard server from a
.conffile, or join NetBird (cloud or self-hosted). Tailscale stays the default; the others are off until you pick them. - Tailscale 1.104.6 built from source down to 18.9 MB, with its state on the card only encrypted, with a key kept in the device's own flash.
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.
- X connects and disconnects; Y on the Account tab removes another account.
- SELECT changes the look. If Tailscale stops answering, A restarts it.
The Devices tab counts how many devices are online, and files sent with Taildrop are announced at the top until the next press.
The device has no TUN interface, so Tailscale runs in userspace mode and other programs reach the tailnet through it: through its SOCKS5 proxy (127.0.0.1:1055) or HTTP proxy (127.0.0.1:1056), as the MiniDeck apps do, or through a port forward for apps that can't use a proxy. List 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.
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.
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 with the device key, like the Tailscale login, 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's own client is included, built from source, and stays off until you 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. Its state is kept encrypted with the device key, like the Tailscale login.
- 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.
MiniScale is not made or supported by Tailscale Inc. or NetBird GmbH. WireGuard is a registered trademark of Jason A. Donenfeld.
- MiniMart: open MiniMart, then Apps > MiniScale. It checks the download and keeps your settings on updates.
- Zip: download
miniscale-VERSION.zipfrom Releases, unzip it onto the root of the SD card, and restart. - Every MiniDeck app at once: minideck-all.zip.
A Miyoo Mini Plus on Onion OS 4.4, with Wi-Fi. A Tailscale account, a Headscale server, a WireGuard server, or a NetBird account. Other devices and firmwares aren't supported.
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. Not made by or affiliated with Miyoo.