Install Tailscale on Linux
You can install the Tailscale client on a variety of Linux distributions using either our automated install script or distribution-specific package managers. This topic covers both mainstream distributions and those with alternative package management systems. For detailed, version-specific instructions for supported platforms, refer to the Tailscale Packages - stable track page.
Mainstream distributions
If you're installing the client on a distribution of Linux that contains a package manager such as apt, yum, or zypper, run the following command:
curl -fsSL https://tailscale.com/install.sh | sh
This is the same script available on our Download page. If you prefer not to use curl | sh, visit the Tailscale Packages - stable track page for manual installation instructions for your distribution.
After installation completes, start the Tailscale client:
sudo tailscale up
The output will display a URL that you can use to authenticate to your Tailscale network (known as a tailnet). After you authenticate, check the Machines page of the admin console to confirm the device appears in your tailnet.
This method works on the following distributions:
- Ubuntu-based distributions
- Debian-based distributions
- Red Hat Enterprise Linux (RHEL), CentOS, Fedora, and derivatives
- Raspberry Pi OS
- Amazon Linux
- openSUSE and SUSE Linux Enterprise
- Oracle Linux
- VMware Photon OS
If there is a distribution that you would like us to officially support, contact our support team so that we can consider adding official support for the distribution.
Other distributions
You can install the Tailscale client on distributions with alternative package managers.
Static binaries
For other Linux distributions not covered by the install script, we provide static binaries as an alternative.
To install a static binary version of the Tailscale client:
-
Download the static binaries for your CPU architecture.
-
Unpack the archive:
tar xvf tailscale_<version>_<architecture>.tgzFor example, if you've downloaded version 1.90.6 of the Tailscale client for AMD64, the command is
tar xvf tailscale_1.90.6_amd64.tgz. -
Start tailscaled daemon:
sudo tailscaled --state=tailscaled.stateIf you want to configure systemd to run tailscaled automatically, a service configuration is available in the
systemd/subdirectory of the unpacked archive. -
Start the Tailscale client:
sudo tailscale up
The output will display a URL that you can use to authenticate to your tailnet. After you authenticate, check the Machines page of the admin console to confirm the device appears in your tailnet.
Verify the installation
When you add a machine to a tailnet, it's assigned a Tailscale IPv4 and IPv6 address. This helps other machines, nodes, and devices know how to reach it over the secure tailnet.
To display the Tailscale IPv4 and IPv6 addresses for your device, run:
tailscale ip
Check the connection status:
tailscale status
Further exploration
Disable key expiry
Devices in a tailnet occasionally need to re-authenticate to stay secure, however you can disable re-authentication. This keeps the device connected without re-authentication, which is useful for always-on systems like servers, Raspberry Pis, media centers, smart home hubs, Docker hosts, and NAS devices.
Disabling key expiry reduces security and can expose your network if the device or key is compromised. Only do this for trusted devices and revoke the key immediately if the device is lost or replaced.
To prevent interruptions, you can disable key expiry by running the command:
sudo tailscale up --auth-key=<your-key> --advertise-exit-node
Alternatively, go to the Machines page of the admin console, select the next to the device, and select Disable key expiry. For more information about using and managing keys in your tailnet, refer to Auth keys.
Use Tailscale SSH
Tailscale SSH lets you manage SSH access to your machine, secure SSH access through your tailnet without exposing SSH to the public internet.
You can enable Tailscale SSH on your machine by running the following:
tailscale set --ssh
Install unstable versions
We offer unstable versions of the Tailscale client for users who want to test new features and fixes before they're distributed to the wider community. If you'd like to help test new features, you can download and install unstable clients from the Tailscale Packages - unstable track page.
For more information, refer to Tailscale client versions and release tracks.
Troubleshooting
Issues using the install script
If the install script fails, it displays diagnostic output information in the terminal session. Include this output when contacting our support team.
Missing kernel modules
Tailscale requires the tun kernel module. Most distributions include this by default. If you encounter errors about missing tun, load it manually:
sudo modprobe tun
To load it automatically on boot, add tun to /etc/modules or /etc/modules-load.d/tun.conf.
Disable logging
By default, Tailscale sends logs to Tailscale servers about device connectivity to a tailnet. We use this data to diagnose and troubleshoot issues when users reach out to Tailscale with an issue. To disable logging:
Edit /etc/default/tailscaled and add:
TS_NO_LOGS_NO_SUPPORT=true
Or add --no-logs-no-support to the FLAGS variable.
Disabling logs may prevent Tailscale from providing technical support.
Distribution and version links
You can find individual topics for Linux distributions below.
Ubuntu
- Ubuntu 16.04 LTS (xenial)
- Ubuntu 18.04 LTS (bionic)
- Ubuntu 19.10 (eoan)
- Ubuntu 20.04 LTS (focal)
- Ubuntu 20.10 (groovy)
- Ubuntu 21.04 (hirsute)
- Ubuntu 21.10 (impish)
- Ubuntu 22.04 (jammy)
- Ubuntu 22.10 (kinetic)
- Ubuntu 23.04 (lunar)
- Ubuntu 23.10 (mantic)
- Ubuntu 24.04 (noble)
- Ubuntu 24.10 (oracular)
- Ubuntu 25.04 (plucky)
- Ubuntu 25.10 (questing)
Debian
- Debian Trixie (stable)
- Debian Bookworm (oldstable)
- Debian Bullseye (oldoldstable)
- Debian Buster (archived)
- Debian Sid (unstable)
- Debian Stretch (archived)
- Raspberry Pi OS (Trixie)
- Raspberry Pi OS (Bookworm)
- Raspberry Pi OS (Bullseye)
- Raspberry Pi OS (Buster)
- Raspberry Pi OS (Stretch)
CentOS
openSUSE
- openSUSE Leap 15.1
- openSUSE Leap 15.2
- openSUSE Leap 15.3
- openSUSE Leap 15.4
- openSUSE Leap 15.5
- openSUSE Leap 15.6
- openSUSE Leap 16.0
- openSUSE Tumbleweed
Oracle Linux
Red Hat® Enterprise Linux
Fedora Linux
Other
If you are interested in support for another platform or architecture, run the script above then contact us by creating a feature request on GitHub, and include the output of the install.sh script.
