tailscale-docker-setup

Configure Tailscale userspace networking in Docker containers without /dev/net/tun.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/TitoPrausee/nexus-toti --skill tailscale-docker-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tailscale-docker-setup
Source: https://github.com/TitoPrausee/nexus-toti/tree/main/data/skills/devops/tailscale-docker-setup
Command: npx skills add https://github.com/TitoPrausee/nexus-toti --skill tailscale-docker-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you run Tailscale inside Docker or other containerized environments when /dev/net/tun and privileged access are unavailable, so you can still join a tailnet from userspace.

Core Features & Use Cases

  • Userspace networking setup for containers, VMs, and sandboxed hosts.
  • Clear startup and authentication flow for the Tailscale daemon and client.
  • Practical troubleshooting notes for socket paths, auth blocking, and common flag mistakes.
  • Use case: deploy a sidecar or app container that must reach private services over Tailscale without host-level network changes.

Quick Start

Ask the assistant to help you configure Tailscale for a containerized environment without a TUN device and include the exact daemon, socket, and authentication steps.

Frequently Asked Questions about tailscale-docker-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Tailscale in Docker without /dev/net/tun access?

Run Tailscale in Docker without /dev/net/tun by configuring the daemon with userspace-networking. You must specify a custom socket path and state directory, then use client commands to authenticate and verify the tailnet connection.

Can I join a tailnet from a container without privileged host access?

Yes, you can join a tailnet from a container without privileged host access by using userspace networking. This sidecar deployment method connects containers to private services without requiring host-level network changes or TUN device availability.

How do I authenticate the Tailscale daemon inside a sandboxed container?

To authenticate the Tailscale daemon inside a sandboxed container, start the daemon with userspace-networking and your custom socket path. Run the client authentication command separately, ensuring it blocks until the tailnet connection is successfully established.

Why is my Tailscale Docker container failing to connect with a TUN error?

Tailscale Docker containers fail with TUN errors when /dev/net/tun is unavailable. Resolve this by applying userspace-networking mode, checking custom socket paths for misconfigurations, and verifying the client authentication command executes successfully.

Does Tailscale userspace networking work for sidecar deployments on sandboxed hosts?

Tailscale userspace networking works for sidecar deployments on sandboxed hosts by bypassing the need for /dev/net/tun. It allows app containers to securely reach private services over the tailnet without requiring host-level network modifications.