Version 3.1.1

This release adds support for UNAS 2 devices. Note that UNAS, UNAS Pro, and UNAS 2 devices need to use userspace networking at the moment, as their kernels do not appear to include the Wireguard module.

You can re-enable userspace networking mode by setting TAILSCALED_FLAGS="--tun userspace-networking" in your /data/tailscale/tailscale-env file and then running /data/tailscale/manage.sh install to reconfigure Tailscale appropriately.

# Install the latest version of Tailscale UDM
curl -sSLq https://raw.github.com/SierraSoftworks/tailscale-udm/main/install.sh | sh

# Then run the following to complete the update
/data/tailscale/manage.sh install!

What's Changed

• fix: Update uninstallation instructions to remove additional packages and files by @bslatyer in #123
• chore(deps): Bump actions/checkout from 4 to 5 by @dependabot[bot] in #124
• chore(deps): Bump SierraSoftworks/gh-releases from 1.0.7 to 1.0.8 by @dependabot[bot] in #127
• Support newer UNAS devices such as the UNAS 2 by @DamianMehers in #137

New Contributors

• @DamianMehers made their first contribution in #137

Full Changelog: v3.1.0...v3.1.1

Version 3.1.0

This release switches to kernel space (TUN) networking as the default configuration for Tailscale on UniFi devices. This networking mode opens up a wide range of options for traffic routing which are unavailable in the legacy --tun userspace-networking mode we previously employed for compatibility reasons. Thanks to the hard work of folks like @jasonwbarnett and @tomvoss we're now able to run Tailscale the way it was originally intended.

If you run into any compatibility issues on your devices, you can re-enable userspace networking mode by setting TAILSCALED_FLAGS="--tun userspace-networking" in your /data/tailscale/tailscale-env file and then running /data/tailscale/manage.sh install to reconfigure Tailscale appropriately.

# Install the latest version of Tailscale UDM
curl -sSLq https://raw.github.com/SierraSoftworks/tailscale-udm/main/install.sh | sh

# Then run the following to complete the update
/data/tailscale/manage.sh install!

⚠️ bullseye-backports moved to archive.debian.org

If you're running into issues when running the installation due to problems downloading packages from bullseye-backports, take a look at #116 for details and guidance on how to fix it.

What's Changed

• update README.md with subnet router configuration by @jasonwbarnett in #105

Full Changelog: v3.0.0...v3.1.0

Version 3.0.0

This release drops support for UniFi OS 1.x and incorporates all of the changes present up to v2.8.0 of this script. We're intentionally keeping the number of changes to a minimum to reduce the potential risks of breakage when migrating to v3.0.0 of this script.

Anyone still running UniFi OS 1.x should stick to the v2.8.0 version of this script going forward.

# Install the latest version of Tailscale UDM
curl -sSLq https://raw.github.com/SierraSoftworks/tailscale-udm/main/install.sh | sh

# Then run the following to complete the update
/data/tailscale/manage.sh install!

What's Changed

• refactor: Drop support for UniFi OS 1.x by @notheotherben in #119

Full Changelog: v2.8.0...v3.0.0

Version 2.8.0

This release adds support for using Tailscale's HTTPs Certificates for your UniFi console, including automatically configuring and renewing these certificates.

# Install the latest version of Tailscale UDM
curl -sSLq https://raw.github.com/SierraSoftworks/tailscale-udm/main/install.sh | sh

# Then run the following to complete the update
/data/tailscale/manage.sh install!

What's Changed

• Add certificate management with UniFi OS integration by @lox in #117

New Contributors

• @lox made their first contribution in #117

Full Changelog: v2.7.0...v2.8.0

Version 2.7.0

This release adds support for the new UniFi UNAS Pro, enabling you to easily install Tailscale on these devices.

# Install the latest version of Tailscale UDM
curl -sSLq https://raw.github.com/SierraSoftworks/tailscale-udm/main/install.sh | sh

# Then run the following to complete the update
/data/tailscale/manage.sh install!

What's Changed

• misc fixes for install by @jasonwbarnett in #106
• Adds Unas Pro support by @andrewmzhang in #112

New Contributors

• @andrewmzhang made their first contribution in #112

Full Changelog: v2.6.1...v2.7.0

Version 2.6.1

This release improves support for automatic upgrades and re-installation after firmware upgrades. It also includes support for setting custom TAILSCALED_FLAGS during the installation process to support advanced installation scenarios in preparation for new Tailscale capabilities which enable tailscaled to be run with kernel mode networking.

# Install the latest version of Tailscale UDM
curl -sSLq https://raw.github.com/SierraSoftworks/tailscale-udm/main/install.sh | sh

# Then run the following to complete the update
/data/tailscale/manage.sh install!

What's Changed

• feat: enable custom TAILSCALED_FLAGS by @jasonwbarnett in #99
• refactor: Improve re-install timer to address OS update issues by @notheotherben in #101

New Contributors

• @jasonwbarnett made their first contribution in #99

Full Changelog: v2.6.0...v2.6.1

Version 2.6.0

This release adds support for UniFi OS 4.x (which is currently in Early Access). To upgrade to the latest version of Tailscale UDM (to support upgrades to UniFi OS 4.x) please run the following:

# Install the latest version of Tailscale UDM
curl -sSLq https://raw.github.com/SierraSoftworks/tailscale-udm/main/install.sh | sh

# Then run the following to complete the update
/data/tailscale/manage.sh install!

What's Changed

• Fix small typo in documentation by @carsso in #85
• Add support for UniFiOS 4 in package/manage.sh by @bslatyer in #88

New Contributors

• @carsso made their first contribution in #85
• @bslatyer made their first contribution in #88

Full Changelog: v2.5.4...v2.6.0

v2.5.4

This release fixes an issue with the packaging script which prevented the automatic update timer from installing correctly.

# Install the latest version of Tailscale UDM
curl -sSLq https://raw.github.com/SierraSoftworks/tailscale-udm/main/install.sh | sh

# Then run the following to complete the update
/data/tailscale/manage.sh install!

Full Changelog: v2.5.3...v2.5.4

v2.5.3

This release fixes an issue preventing the automatic update functionality from working as expected.

# Install the latest version of Tailscale UDM
curl -sSLq https://raw.github.com/SierraSoftworks/tailscale-udm/main/install.sh | sh

# As a one-off, you'll need to run this to ensure that the tailscale-install.service is updated (if you're upgrading from a version < 2.5.2)
systemctl disable tailscale-install.service

# Then run the following to complete the update
/data/tailscale/manage.sh install!

What's Changed

• Updated the install script to better recover from broken service symlinks as raised in #82

Full Changelog: v2.5.2...v2.5.3

Version 2.5.2

This release fixes an issue preventing the automatic update functionality from working as expected.

# Install the latest version of Tailscale UDM
curl -sSLq https://raw.github.com/SierraSoftworks/tailscale-udm/main/install.sh | sh

# As a one-off, you'll need to run this to ensure that the tailscale-install.service is updated
systemctl disable tailscale-install.service

# Then run the following to complete the update
/data/tailscale/manage.sh install!

What's Changed

• Fixed the tailscale-install.service to ensure that automatic updates actually run as expected.

Full Changelog: v2.5.1...v2.5.2