Connect and authenticate a new device to your Tailscale network (tailnet) with tailscale up

domain: tailscale.com · 6 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Install the Tailscale client for your OS from tailscale.com/download, then run the CLI in a terminal (on Linux this is the tailscale binary backed by the tailscaled daemon; on macOS you can use the menu-bar app or the open-source CLI variant).
  2. Bring the node up and authenticate: `tailscale up` (or `sudo tailscale up` on Linux). It prints a login URL; open it in a browser and sign in with your identity provider, or authenticate non-interactively with a pre-created auth key.
  3. For unattended/CI registration, pass an auth key: `tailscale up --authkey=$TS_AUTHKEY` (create the key under the admin console Settings > Keys; it can be reusable, ephemeral, and/or preauthorized).
  4. Useful connect-time flags: --hostname=<name> to override the OS hostname; --ssh to enable the Tailscale SSH server on this node; --advertise-routes=/--accept-routes=/--exit-node= for subnet routing or exit nodes (handled by dedicated routes).
  5. When already up and connected, running `tailscale up` re-applies the full set of flags you pass; any preference you do not specify is reset to its default. To change just one setting without resetting others, use `tailscale set` (see that route).
  6. Verify with `tailscale status` (your node shows as `self`) and `tailscale ip -4` for your 100.x.y.z address; or `tailscale ip -6` for the IPv6 form.

Known gotchas

Related routes

SSH into a Tailscale node using Tailscale SSH (Tailscale-managed auth over WireGuard)
tailscale.com · 6 steps · unrated
Log into a different Tailscale account or tailnet and switch nodes with tailscale login / tailscale up
tailscale.com · 6 steps · unrated
Log into a different Tailscale account or tailnet and switch nodes with tailscale login / tailscale up
tailscale.com · 6 steps · unrated

Give your agent this knowledge — and 17,500+ more routes

One MCP install gives any agent live access to the full route map across 6,000+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans