Tailscale-Docker

Tailscale-Docker

Official

Docker app from EDACerton's Repository

Overview

To access Unraid resources, install the Tailscale plugin instead.

This container provides Tailscale for use as a sidecar for Docker containers connected to ipvlan (e.g., br0) networks, or for use with node sharing.

Important Information

This container is only intended for advanced networking configurations, so it is expected that you know what you are doing.

Support will not be provided for using this container to access Unraid resources (WebGUI, shares, etc.).

State Configuration

This container can be configured as either an ephemeral or persistent node.

To create a persistent node:

  1. (Optional) Generate an authentication key in the Tailscale admin console.
  2. Set Hostname, State Storage, and (if applicable) Authentication Key in the container configuration.
  3. If you did not set an authentication key, open the container logs to obtain the login URL to join the node to your tailnet. Caution: If you use this method, you must complete the login within 60 seconds of the container starting.

To create an ephemeral node:

  1. Generate an ephemeral authentication key in the Tailscale admin console.
  2. Set Hostname and Authentication Key in the container configuration. Leave State Storage blank.

Readme

View on GitHub

Tailscale

https://tailscale.com

Private WireGuard® networks made easy

Overview

This repository contains the majority of Tailscale's open source code. Notably, it includes the tailscaled daemon and the tailscale CLI tool. The tailscaled daemon runs on Linux, Windows, macOS, and to varying degrees on FreeBSD and OpenBSD. The Tailscale iOS and Android apps use this repo's code, but this repo doesn't contain the mobile GUI code.

Other Tailscale repos of note:

For background on which parts of Tailscale are open source and why, see https://tailscale.com/opensource/.

Using

We serve packages for a variety of distros and platforms at https://pkgs.tailscale.com.

Other clients

The macOS, iOS, and Windows clients use the code in this repository but additionally include small GUI wrappers. The GUI wrappers on non-open source platforms are themselves not open source.

Building

We always require the latest Go release, currently Go 1.26. (While we build releases with our Go fork, its use is not required.)

go install tailscale.com/cmd/tailscale{,d}

If you're packaging Tailscale for distribution, use build_dist.sh instead, to burn commit IDs and version info into the binaries:

./build_dist.sh tailscale.com/cmd/tailscale
./build_dist.sh tailscale.com/cmd/tailscaled

If your distro has conventions that preclude the use of build_dist.sh, please do the equivalent of what it does in your distro's way, so that bug reports contain useful version information.

Bugs

Please file any issues about this code or the hosted service on the issue tracker.

Contributing

PRs welcome! But please file bugs. Commit messages should reference bugs.

We require Developer Certificate of Origin Signed-off-by lines in commits.

See commit-messages.md (or skim git log) for our commit message style.

About Us

Tailscale is primarily developed by the people at https://github.com/orgs/tailscale/people. For other contributors, see:

Legal

WireGuard is a registered trademark of Jason A. Donenfeld.

Install Tailscale-Docker on Unraid in a few clicks.

Find Tailscale-Docker in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Tailscale-Docker Review the template variables and paths Click Install
Explore Unraid OS

Categories

Network > VPN

Download Statistics

140,894,798
Total Downloads

Related apps

Explore more like this

Explore all
VPN apps

Links

Projectgithub.comSupportforums.unraid.netDocker Hubhub.docker.comTemplateraw.githubusercontent.com

Details

Repository
tailscale/tailscale:stable
Registry
https://hub.docker.com/r/tailscale/tailscale
Last Updated2026-06-17
First Seen2023-12-15

Runtime arguments

Network
bridge
Shell
sh
Privileged
false

Template configuration

State StoragePathrw

Path to store Tailscale state. Leave blank for ephemeral nodes.

Target
/state
Default
/mnt/user/appdata/tailscale
HostnameVariable

Name to be assigned to node on the tailnet.

Target
TS_HOSTNAME
Default
unraid-docker
Authentication KeyVariable

Authentication key to use to join the tailnet. Required for ephemeral nodes. Only used on first start if state is persistent.

Target
TS_AUTHKEY
Extra ArgumentsVariable

Extra arguments to pass via tailscale up.

Target
TS_EXTRA_ARGS
TS_STATE_DIRVariable
Value
/state
TS_AUTH_ONCEVariable
Value
true
TS_USERSPACEVariable
Value
true