dirien/yet-another-agent-harness / .claude/skills/tailscale-install
tailscale-install
FlaggedInstall and configure Tailscale across platforms. Detects OS, distro, and environment (including WSL2 and containers). Verifies existing installations, performs platform-appropriate install, and guides initial connection. Use when setting up Tailscale on a new machine, onboarding a server to a tailnet, or verifying an existing install.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.3 KB |
| references/platform-install-commands.md | markdown | 5.1 KB |
| references/post-install-checklist.md | markdown | 4.2 KB |
references/platform-install-commands.md
View on GitHub<!-- Copyright 2025-2026 Richard Shade. Licensed under Apache-2.0. -->
<!-- SPDX-License-Identifier: Apache-2.0 -->
# Platform Install Commands
Exhaustive per-platform Tailscale installation commands. The agent should
use platform detection results from SKILL.md to select the correct section.
## Linux — Quick Install (All Distros)
The official one-liner detects the distro and installs automatically:
```bash
curl -fsSL https://tailscale.com/install.sh | sh
```
This works on Debian, Ubuntu, CentOS, RHEL, Fedora, Amazon Linux, Arch,
and most other distributions. Use the distro-specific sections below when
the one-liner is unavailable or the environment requires explicit repo
configuration.
## Linux — Debian / Ubuntu (apt)
```bash
# Add Tailscale GPG key and repository
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/$(lsb_release -cs).noarmor.gpg \
| sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/$(lsb_release -cs).tailscale-keyring.list \
| sudo tee /etc/apt/sources.list.d/tailscale.list
# Install
sudo apt-get update
sudo apt-get install -y tailscale
# Enable and start daemon
sudo systemctl enable --now tailscaled
```
For Debian (not Ubuntu), replace `ubuntu` with `debian` in the URLs above.
## Linux — RHEL / Fedora / CentOS (dnf/yum)
```bash
# Add Tailscale repository
sudo dnf config-manager --add-repo \
https://pkgs.tailscale.com/stable/fedora/tailscale.repo
# Install
sudo dnf install -y tailscale
# Enable and start daemon
sudo systemctl enable --now tailscaled
```
For CentOS/RHEL, replace `fedora` with `centos` or `rhel` in the repo URL.
For older systems without `dnf`, use `yum` instead.
## Linux — Arch (pacman)
```bash
sudo pacman -S tailscale
# Enable and start daemon
sudo systemctl enable --now tailscaled
```
## Linux — Alpine (apk)
```bash
sudo apk add tailscale
# Start daemon (OpenRC)
sudo rc-update add tailscale
sudo rc-service tailscale start
```
## Linux — openSUSE / SUSE (zypper)
```bash
# Add Tailscale repository
sudo zypper addrepo -g -r \
https://pkgs.tailscale.com/stable/opensuse/tumbleweed/tailscale.repo
# Install
sudo zypper install tailscale
# Enable and start daemon
sudo systemctl enable --now tailscaled
```
For Leap, replace `tumbleweed` with the Leap version (e.g., `15.5`).
## Linux — Raspberry Pi OS
Use the Debian instructions above. Raspberry Pi OS is Debian-based:
```bash
curl -fsSL https://tailscale.com/install.sh | sh
sudo systemctl enable --now tailscaled
```
## macOS — Homebrew
```bash
brew install --cask tailscale
```
After installation, open Tailscale from Applications to start the system
extension. The CLI is available at:
```bash
# Homebrew install puts CLI in PATH
tailscale version
```
## macOS — Mac App Store
Install "Tailscale" from the Mac App Store. The App Store version uses a
network extension (not kernel extension).
The CLI is NOT in PATH by default. Add an alias:
```bash
alias tailscale="/Applications/Tailscale.app/Contents/MacOS/Tailscale"
```
Or add to shell profile for persistence:
```bash
echo 'alias tailscale="/Applications/Tailscale.app/Contents/MacOS/Tailscale"' \
>> ~/.zshrc
```
## Windows — WinGet
```powershell
winget install tailscale.tailscale
```
Restart the terminal after installation to pick up the CLI in PATH.
## Windows — Chocolatey
```powershell
choco install tailscale
```
## Windows — MSI Installer
Download the latest MSI from the Tailscale website and run:
```powershell
msiexec /i tailscale-setup.msi /quiet
```
## WSL2 — Do NOT Install Linux Package
Tailscale should run on the **Windows host**, not inside WSL2. The WSL2
virtual machine shares the host network stack, so installing Tailscale
inside WSL2 creates conflicting WireGuard tunnels.
**Correct approach:**
1. Install Tailscale on the Windows host (WinGet, Chocolatey, or MSI)
2. Access the CLI from WSL2 via `tailscale.exe`:
```bash
# From inside WSL2
tailscale.exe version
tailscale.exe status
tailscale.exe ping <peer>
```
1. MagicDNS hostnames resolve automatically from WSL2 when the Windows
host is connected to the tailnet.
**If `tailscale.exe` is not found in WSL2**, ensure the Windows PATH is
shared with WSL2. Check `/etc/wsl.conf`:
```ini
[interop]
appendWindowsPath = true
```
## Docker
```bash
docker run -d \
--name tailscale \
--hostname tailscale-container \
--cap-add NET_ADMIN \
--cap-add NET_RAW \
--device /dev/net/tun:/dev/net/tun \
-v tailscale-state:/var/lib/tailscale \
-e TS_AUTHKEY=tskey-auth-<key> \
-e TS_EXTRA_ARGS=--advertise-tags=tag:container \
tailscale/tailscale:latest
```
Required capabilities: `NET_ADMIN` and `NET_RAW`. The `/dev/net/tun`
device must be available. Use `TS_AUTHKEY` for unattended authentication.
## Docker Compose
```yaml
services:
tailscale:
image: tailscale/tailscale:latest
hostname: tailscale-service
cap_add:
- NET_ADMIN
- NET_RAW
devices:
- /dev/net/tun:/dev/net/tun
volumes:
- tailscale-state:/var/lib/tailscale
environment:
- TS_AUTHKEY=tskey-auth-<key>
- TS_EXTRA_ARGS=--advertise-tags=tag:container
volumes:
tailscale-state:
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |