Skip to content

Compatibility

Jump to bottom
Braeden Slatyer edited this page May 8, 2026 · 4 revisions

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

Compatible Devices

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

  • Any variant of the UniFi Cloud Gateway families
  • Any variant of the UniFi Control Plane families
  • Any variant of the UniFi Independent Gateway families
  • Any variant of the UniFi Next-Gen NVR families

    Note: This device is only supported via userspace networking mode, as the kernel on this device does not support the required modules.

  • Any variant of the UniFi Next-Gen Storage families

    Note: This device is only supported via userspace networking mode, as the kernel on this device does not support the required modules.

  • Any variant of a UniFi device running UniFi OS 2.x or later not listed above or below

Incompatible Devices

This package is NOT compatible with the following variants of UniFi devices:

  • 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 an EoL UniFi device not listed above

Compatibility Requirements

We expect that it should function on most consumer-grade UniFi devices without issue, but if you run into any problems, please open an issue and provide the following information:

  • The device you are running on (e.g., UDM Pro)
  • The UniFi OS version you are running (e.g., 2.4.8 - this can be found by running /usr/bin/ubnt-device-info firmware_detail)
  • The steps you took to install Tailscale and any errors you encountered.

UniFi OS 1.x Support

This package is no longer compatible with UniFi OS 1.x (Legacy OS w/ Podman). If you are running UniFi OS 1.x and cannot upgrade to the latest stable version, use the legacy version of this package, available in the legacy branch of this repository. The legacy version is no longer maintained and may not work with the latest Tailscale release.

Clone this wiki locally