Docs / Admin

Taildrop (alpha)

Taildrop is a feature that makes it easy to send files between your personal devices on a Tailscale network.

Like all traffic sent over Tailscale, Taildrop transfers files over encrypted peer-to-peer connections, using the fastest available path. This makes it a great solution for sending sensitive or large files without third-party servers in the middle.

This feature is in public alpha, with many planned improvements to the UX and capabilities. To try Taildrop today, you’ll need to opt-in for your network and use Tailscale v1.8 or greater.

Enabling Taildrop for your network

Since Taildrop is an alpha feature, you’ll need to opt your network in to the test to use it. You can do so from the features page of the admin console, by turning on the “Send Files” feature.

Sending files with Taildrop

You can transfer any kind of files with Taildrop.

Taildrop is currently limited to sending files between your own personal devices. You cannot send files to devices owned by other users even on the same Tailscale network.

Taildrop also requires both devices to be running Tailscale v1.8 or greater. Older devices will not appear.

macOS

Send files to other devices via the right-click “Share…” menu.

Files received on macOS will be placed in the ~/Downloads directory.

iOS

Send files to your other devices via the Share menu. Choose Tailscale and tap the device you’d like to send files to.

The first time you use Taildrop, the “Tailscale” option may be hidden in the “More…” section of the menu. iOS sorts Share apps by frequency of use, and so Tailscale should be visible once you’ve sent a file.

Files received on iOS will pop up a notification. Opening this notification will show the files in Files.app.

Windows

Send files to other devices by right-clicking on the files and choosing “Send with Tailscale…” from the menu.

Files sent to Windows get placed on your C:\Users\(username)\Desktop directory.

Android

Taildrop is not currently supported on Android, but will be in the coming months. Follow this GitHub issue for updates.

Linux

You can send files using the tailscale file subcommand of the CLI.

To send a file, use:

tailscale file cp <files> <name-or-ip>:

For example, you can send a text file to your phone with the command:

tailscale file cp ./my-file.txt my-phone:

The last argument is the name of the destination followed by a colon, intended to disambiguate filenames from device names, and to roughly match the scp syntax.

You can find the IP addresses and names of your other nodes using the tailscale status command.

To receive a file, use this command:

sudo tailscale file get .

Where . can be any directory you’d like to copy files to.

Because tailscaled runs as root, files are received by root. In the current version, root has to retrieve the files using sudo.

Last updated