juanfont/headscale · error

%s tailscale node has not reached running: %w

Error message

%s tailscale node has not reached running: %w

What it means

Error "%s tailscale node has not reached running: %w" thrown in juanfont/headscale.

Source

Thrown at integration/scenario.go:1026

				if !strings.Contains(loginURL.String(), "/oidc/") {
					_ = s.runHeadscaleRegister(userStr, body)
				}

				return nil
			})

			log.Printf("client %s is ready", client.Hostname())
		}

		err := user.joinWaitGroup.Wait()
		if err != nil {
			return err
		}

		for _, client := range user.Clients {
			err := client.WaitForRunning(integrationutil.PeerSyncTimeout())
			if err != nil {
				return fmt.Errorf(
					"%s tailscale node has not reached running: %w",
					client.Hostname(),
					err,
				)
			}
		}

		return nil
	}

	return fmt.Errorf("bringing up tailscale node: %w", errNoUserAvailable)
}

type debugJar struct {
	inner *cookiejar.Jar
	mu    sync.RWMutex
	store map[string]map[string]map[string]*http.Cookie // domain -> path -> name -> cookie
}

View on GitHub (pinned to 565fd254d0)

Solutions

1. Inspect the wrapped error for the underlying cause and correct the failing condition (tailscale node has not reached running); retry the operation after fixing the input, configuration, or environment.

Example fix

Inspect the wrapped error for the underlying cause and correct the failing condition (tailscale node has not reached running); retry the operation after fixing the input, configuration, or environment.

When it happens

Trigger: Thrown at integration/scenario.go:1026 when the library encounters an invalid state.

Common situations: The named tailscale node did not reach Running state. Check tailscale status inside the container and headscale node registration.

AI-assisted analysis of juanfont/headscale@565fd254d0 (2026-08-15). Data as JSON: /api/errors/a5f3727535b725ca. Report an issue: GitHub.