The easiest, most secure way to use WireGuard and 2FA.
Go to file
Andrew Dunham bcceef3682
Some checks failed
checklocks / checklocks (push) Has been cancelled
CodeQL / Analyze (go) (push) Has been cancelled
Dockerfile build / deploy (push) Has been cancelled
CI / gomod-cache (push) Has been cancelled
CI / fuzz (push) Has been cancelled
update-flake / update-flake (push) Has been cancelled
tailscale.com/cmd/vet / vet (push) Has been cancelled
CI / race-root-integration (1/4) (push) Has been cancelled
CI / race-root-integration (2/4) (push) Has been cancelled
CI / race-root-integration (3/4) (push) Has been cancelled
CI / race-root-integration (4/4) (push) Has been cancelled
CI / test (-race, amd64, 1/3) (push) Has been cancelled
CI / test (-race, amd64, 2/3) (push) Has been cancelled
CI / test (-race, amd64, 3/3) (push) Has been cancelled
CI / test (386) (push) Has been cancelled
CI / test (amd64) (push) Has been cancelled
CI / Windows (${{ matrix.name || matrix.shard}}) (win-bench, benchmarks) (push) Has been cancelled
CI / Windows (${{ matrix.name || matrix.shard}}) (win-shard-1-2, 1/2) (push) Has been cancelled
CI / Windows (${{ matrix.name || matrix.shard}}) (win-shard-2-2, 2/2) (push) Has been cancelled
CI / Windows (win-tool-go) (push) Has been cancelled
CI / privileged (push) Has been cancelled
CI / vm (push) Has been cancelled
CI / cross (386, linux) (push) Has been cancelled
CI / cross (amd64, darwin) (push) Has been cancelled
CI / cross (amd64, freebsd) (push) Has been cancelled
CI / cross (amd64, openbsd) (push) Has been cancelled
CI / cross (amd64, windows) (push) Has been cancelled
CI / cross (arm, 5, linux) (push) Has been cancelled
CI / cross (arm, 7, linux) (push) Has been cancelled
CI / cross (arm64, darwin) (push) Has been cancelled
CI / cross (arm64, linux) (push) Has been cancelled
CI / cross (arm64, windows) (push) Has been cancelled
CI / cross (loong64, linux) (push) Has been cancelled
CI / ios (push) Has been cancelled
CI / crossmin (amd64, illumos) (push) Has been cancelled
CI / crossmin (amd64, plan9) (push) Has been cancelled
CI / crossmin (amd64, solaris) (push) Has been cancelled
CI / crossmin (ppc64, aix) (push) Has been cancelled
CI / android (push) Has been cancelled
CI / wasm (push) Has been cancelled
CI / tailscale_go (push) Has been cancelled
CI / depaware (push) Has been cancelled
CI / go_generate (push) Has been cancelled
CI / go_mod_tidy (push) Has been cancelled
CI / licenses (push) Has been cancelled
CI / staticcheck (${{ matrix.name }}) (--with-tags-all=darwin, arm64, darwin, macOS) (push) Has been cancelled
CI / staticcheck (${{ matrix.name }}) (--with-tags-all=linux, amd64, linux, Linux) (push) Has been cancelled
CI / staticcheck (${{ matrix.name }}) (--with-tags-all=windows, amd64, windows, Windows) (push) Has been cancelled
CI / staticcheck (${{ matrix.name }}) (--without-tags-any=windows,darwin,linux --shard=1/4, amd64, linux, Portable (1/4)) (push) Has been cancelled
CI / staticcheck (${{ matrix.name }}) (--without-tags-any=windows,darwin,linux --shard=2/4, amd64, linux, Portable (2/4)) (push) Has been cancelled
CI / staticcheck (${{ matrix.name }}) (--without-tags-any=windows,darwin,linux --shard=3/4, amd64, linux, Portable (3/4)) (push) Has been cancelled
CI / staticcheck (${{ matrix.name }}) (--without-tags-any=windows,darwin,linux --shard=4/4, amd64, linux, Portable (4/4)) (push) Has been cancelled
CI / notify_slack (push) Has been cancelled
CI / merge_blocker (push) Has been cancelled
CI / check_mergeability_strict (push) Has been cancelled
CI / check_mergeability (push) Has been cancelled
cmd/tailscale/cli: allow fetching keys from AWS Parameter Store
This allows fetching auth keys, OAuth client secrets, and ID tokens (for
workload identity federation) from AWS Parameter Store by passing an ARN
as the value. This is a relatively low-overhead mechanism for fetching
these values from an external secret store without needing to run a
secret service.

Usage examples:

    # Auth key
    tailscale up \
      --auth-key=arn:aws:ssm:us-east-1:123456789012:parameter/tailscale/auth-key

    # OAuth client secret
    tailscale up \
      --client-secret=arn:aws:ssm:us-east-1:123456789012:parameter/tailscale/oauth-secret \
      --advertise-tags=tag:server

    # ID token (for workload identity federation)
    tailscale up \
      --client-id=my-client \
      --id-token=arn:aws:ssm:us-east-1:123456789012:parameter/tailscale/id-token \
      --advertise-tags=tag:server

Updates tailscale/corp#28792

Signed-off-by: Andrew Dunham <andrew@tailscale.com>
2026-01-29 18:09:56 -05:00
.bencher bencher: add config to suppress failures on benchmark regressions. 2021-10-01 16:16:02 -07:00
.github .github/workflows: set CMD_GO_USE_GIT_HASH=true for our cmd/go 2026-01-28 18:45:12 -08:00
appc appc,ipn/ipnlocal: Add split DNS entries for conn25 peers 2026-01-26 08:10:38 -08:00
atomicfile all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
chirp all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
client all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
clientupdate all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
cmd cmd/tailscale/cli: allow fetching keys from AWS Parameter Store 2026-01-29 18:09:56 -05:00
control control/controlclient: add PersistView.Valid() check in NetmapFromMapResponseForDebug (#17878) 2026-01-29 10:45:13 +00:00
derp all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
disco all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
docs all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
doctor all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
drive all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
envknob all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
feature cmd/tailscale/cli: allow fetching keys from AWS Parameter Store 2026-01-29 18:09:56 -05:00
gokrazy all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
health all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
hostinfo hostinfo: retrieve OS version for Macs running the OSS client 2026-01-27 15:51:07 +00:00
internal cmd/tailscale/cli: allow fetching keys from AWS Parameter Store 2026-01-29 18:09:56 -05:00
ipn ipn/ipnlocal/netmapcache: report the correct error for a missing column (#18547) 2026-01-28 14:32:40 -08:00
jsondb all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
k8s-operator all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
kube all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
licenses licenses: update license notices 2026-01-29 09:35:21 -08:00
log all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
logpolicy all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
logtail logtail/filch: fix panic in concurrent file access (#18555) 2026-01-28 18:28:25 -08:00
maths all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
metrics all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
net ipn/localapi: stop logging "broken pipe" errors (#18487) 2026-01-26 16:41:03 -08:00
omit all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
packages/deb all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
paths all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
portlist all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
posture all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
prober all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
proxymap all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
release all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
safesocket all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
safeweb all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
scripts all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
sessionrecording all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
ssh/tailssh all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
syncs all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
tailcfg all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
tempfork feature/c2n: move answerC2N code + deps out of control/controlclient 2025-10-04 13:16:49 -07:00
tka all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
tool tool/gocross, pull-toolchain.sh: support a "next" Go toolchain 2026-01-27 14:07:35 -08:00
tsconsensus all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
tsconst all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
tsd all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
tsnet tsnet: make ListenService examples consistent with other tsnet examples 2026-01-26 14:59:18 -07:00
tstest tstest/integration/testcontrol: fix unguarded read of DNS config 2026-01-24 14:38:48 -08:00
tstime all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
tsweb all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
types ipn/ipnlocal/netmapcache: add a package to split and cache network maps (#18497) 2026-01-26 14:55:30 -08:00
util all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
version all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
wf wf: allow limited broadcast to/from permitted interfaces when using an exit node on Windows 2026-01-23 18:30:38 -06:00
wgengine ipn/localapi: stop logging "broken pipe" errors (#18487) 2026-01-26 16:41:03 -08:00
wif all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
words all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
.gitattributes .: add .gitattributes entry to use Go hunk-header driver 2021-12-03 17:56:02 -08:00
.gitignore Add .stignore for syncthing (#18540) 2026-01-27 16:15:17 -08:00
.golangci.yml .github: Bump golangci/golangci-lint-action from 6.5.0 to 7.0.0 (#15476) 2025-04-14 16:04:36 -06:00
.stignore Add .stignore for syncthing (#18540) 2026-01-27 16:15:17 -08:00
ALPINE.txt docker: bump alpine v3.19 -> 3.22 (#17155) 2025-09-17 20:22:24 +01:00
api.md {api.md,publicapi}: remove old API docs (#13468) 2024-09-13 14:10:33 -06:00
assert_ts_toolchain_match.go cmd/printdep: add --next flag to use rc Go build hash instead 2026-01-27 14:49:56 -08:00
build_dist.sh build_dist.sh: keep --extra-small making a usable build, add --min 2025-10-06 21:15:25 -07:00
build_docker.sh build_docker.sh: support including extra files (#17405) 2025-10-02 13:29:03 +01:00
CODE_OF_CONDUCT.md CODE_OF_CONDUCT.md: update code of conduct 2025-10-28 08:58:00 -07:00
CODEOWNERS CODEOWNERS: add the start of an owners file 2023-08-16 15:57:29 -07:00
Dockerfile all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
Dockerfile.base all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
flake.lock .github/Makefile/flake: update nix flake support (#16636) 2025-08-19 10:46:07 -04:00
flake.nix ipn/ipnlocal/netmapcache: add a package to split and cache network maps (#18497) 2026-01-26 14:55:30 -08:00
go.mod ipn/ipnlocal/netmapcache: add a package to split and cache network maps (#18497) 2026-01-26 14:55:30 -08:00
go.mod.sri ipn/ipnlocal/netmapcache: add a package to split and cache network maps (#18497) 2026-01-26 14:55:30 -08:00
go.sum cmd,feature: add identity token auto generation for workload identity (#18373) 2026-01-14 15:00:59 +00:00
go.toolchain.branch go.toolchain.branch: bump to go1.25 (#16954) 2025-08-26 07:44:26 -07:00
go.toolchain.next.branch tool/gocross, pull-toolchain.sh: support a "next" Go toolchain 2026-01-27 14:07:35 -08:00
go.toolchain.next.rev tool/gocross, pull-toolchain.sh: support a "next" Go toolchain 2026-01-27 14:07:35 -08:00
go.toolchain.rev go.toolchain.rev: bump for cmd/go caching work 2026-01-28 14:59:46 -08:00
go.toolchain.rev.sri go.toolchain.rev: bump for cmd/go caching work 2026-01-28 14:59:46 -08:00
go.toolchain.version go.toolchain.rev: update to Go 1.25.6 (#18507) 2026-01-23 17:08:46 -08:00
gomod_test.go all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
header.txt all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
LICENSE all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
license_test.go all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
Makefile Makefile, cmd/*/depaware.txt: split out vendor packages explicitly 2025-10-01 13:02:06 -07:00
PATENTS Move Linux client & common packages into a public repo. 2020-02-09 09:32:57 -08:00
pkgdoc_test.go all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
pull-toolchain.sh tool/gocross, pull-toolchain.sh: support a "next" Go toolchain 2026-01-27 14:07:35 -08:00
README.md README: update the version of Go in the README 2025-09-29 22:09:25 +01:00
SECURITY.md Add a SECURITY.md for vulnerability reports. 2020-02-11 10:26:41 -08:00
shell.nix ipn/ipnlocal/netmapcache: add a package to split and cache network maps (#18497) 2026-01-26 14:55:30 -08:00
staticcheck.conf all: cleanup unused code, part 2 (#10670) 2023-12-21 17:40:03 -08:00
update-flake.sh flake.nix: update Nix to use tailscale/go 1.25.2 (#17500) 2025-10-08 14:37:47 -04:00
version_tailscale_test.go all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
version_test.go all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
version-embed.go cmd/printdep: add --next flag to use rc Go build hash instead 2026-01-27 14:49:56 -08:00
VERSION.txt VERSION.txt: this is v1.95.0 (#18414) 2026-01-14 14:19:17 -08:00

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.25. (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:

WireGuard is a registered trademark of Jason A. Donenfeld.