Skip to content

SierraSoftworks/tailscale-udm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tailscale on Unifi Dream Machine

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.

Installation

  1. 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).

  2. 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
  3. Follow the on-screen steps to configure tailscale and connect it to your network.

  4. Confirm that tailscale is working by running /mnt/data/tailscale/tailscale status

Management

Restarting Tailscale

/mnt/data/tailscale/manage.sh restart

Upgrading Tailscale

/mnt/data/tailscale/manage.sh update

Remove Tailscale

To remove Tailscale, you can run the following command, or run the steps below manually.

/mnt/data/tailscale/manage.sh uninstall

Manual Steps

  1. Kill the tailscaled daemon with killall tailscaled.
  2. Remove the boot script using rm /mnt/data/on_boot.d/10-tailscaled.sh
  3. Have tailscale cleanup after itself using /mnt/data/tailscale/tailscaled --cleanup.
  4. Remove the tailscale binaries and state using rm -Rf /mnt/data/tailscale.

Contributing

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.