This repo contains the scripts necessary to install and run a tailscale instance on your Unifi Dream Machine (UDM/UDM Pro). It does so by piggy-backing on the excellent boostchicken/udm-utilities to provide a persistent service and runs using Tailscale's usermode networking feature.
-
Follow the steps to install the boostchicken
on-boot-script
here.⚠ Make sure that you exit the
unifi-os
shell before moving onto step 2 (or you won't be able to find the/mnt/data
directory). -
Run the
install.sh
script to install the latest version of the Tailscale UDM package on your UDM.# Install the latest version of Tailscale UDM curl -sSLq https://raw.github.com/SierraSoftworks/tailscale-udm/main/install.sh | sh
-
Follow the on-screen steps to configure
tailscale
and connect it to your network. -
Confirm that
tailscale
is working by running/mnt/data/tailscale/tailscale status
/mnt/data/tailscale/manage.sh restart
/mnt/data/tailscale/manage.sh update
To remove Tailscale, you can run the following command, or run the steps below manually.
/mnt/data/tailscale/manage.sh uninstall
- Kill the
tailscaled
daemon withkillall tailscaled
. - Remove the boot script using
rm /mnt/data/on_boot.d/10-tailscaled.sh
- Have tailscale cleanup after itself using
/mnt/data/tailscale/tailscaled --cleanup
. - Remove the tailscale binaries and state using
rm -Rf /mnt/data/tailscale
.
There are clearly lots of folks who are interested in running Tailscale on their UDMs. If you're one of those people and have an idea for how this can be improved, please create a PR and we'll be more than happy to incorporate the changes.