juanfont/headscale · error

adding tailscale node: %w

Error message

adding tailscale node: %w

What it means

Error "adding tailscale node: %w" thrown in juanfont/headscale.

Source

Thrown at integration/scenario.go:740

				user.Clients[tsClient.Hostname()] = tsClient

				s.mu.Unlock()

				return nil
			})
		}

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

		log.Printf("testing versions %v, MustTestVersions %v", lo.Uniq(versions), MustTestVersions)

		return nil
	}

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

// RunTailscaleUp will log in all of the [TailscaleClient]s associated with a
// [User] to the given [ControlServer] (by URL).
func (s *Scenario) RunTailscaleUp(
	userStr, loginServer, authKey string,
) error {
	if user, ok := s.users[userStr]; ok {
		for _, client := range user.Clients {
			c := client

			user.joinWaitGroup.Go(func() error {
				return c.Login(loginServer, authKey)
			})
		}

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

View on GitHub (pinned to 565fd254d0)

Solutions

1. Inspect the wrapped error for the underlying cause and correct the failing condition (adding tailscale node); 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 (adding tailscale node); retry the operation after fixing the input, configuration, or environment.

When it happens

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

Common situations: Adding the tailscale node container to the scenario failed. Check Docker is healthy and the requested tailscale version image is available.

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