Skip to content

Compatibility

Braeden Slatyer edited this page Jul 18, 2026 · 4 revisions

Compatibility

Tip

You can confirm your UniFi OS (UOS) version by running /usr/bin/ubnt-device-info firmware_detail

This package is compatible with UniFi OS 2.x or later and works on the following UniFi families:

  • Any variant of the UniFi Cloud Gateway family
  • Any variant of the UniFi Control Plane family
  • Any variant of the UniFi Independent Gateway family
  • Any UniFi device running UniFi OS 2.x or later and not listed above or below

Note

These devices are supported only in userspace networking mode, because their kernel does not support the required modules.

  • Any variant of the UniFi Next-Gen NVR family
  • Any variant of the UniFi Next-Gen Storage family

Important

This package is NOT compatible with these UniFi device variants:

  • Any variant of the UniFi Cloud Key Gen 1 (UCK-G1)
  • Any variant of the UniFi Security Gateway (USG)
  • Any variant of the UniFi Travel Router (UTR)
  • Any variant of a UniFi device running BusyBox
  • Any variant of a UniFi device running UniFi OS 1.x (Legacy OS w/ Podman)
  • Any variant of a UniFi device that has reached end-of-life (EoL) and is not listed above

We expect this to work on most UniFi devices, but if you run into any problems, please open an issue and include the device you are running on, the UniFi OS version you are running, and the steps you took to install Tailscale, along with any errors you encountered.

Warning

This package is no longer compatible with UniFi OS 1.x (Legacy OS w/ Podman). If you cannot upgrade to the latest stable UniFi OS version, use the latest v2.x release from the legacy branch of this repository. We no longer maintain support for UniFi OS 1.x.

Clone this wiki locally