tailscale/tailscale · error

ErrNotConfigured

ErrNotConfigured

Error message

not configured

What it means

ErrNotConfigured is returned when the requested policy setting is not present in the snapshot: no policy source provides a value for that key. MaybeErrorText deliberately suppresses user-facing error text for this sentinel.

Source

Thrown at util/syspolicy/setting/errors.go:12

// Copyright (c) Tailscale Inc & contributors
// SPDX-License-Identifier: BSD-3-Clause

package setting

import (
	"errors"
)

var (
	// ErrNotConfigured is returned when the requested policy setting is not configured.
	ErrNotConfigured = errors.New("not configured")
	// ErrTypeMismatch is returned when there's a type mismatch between the actual type
	// of the setting value and the expected type.
	ErrTypeMismatch = errors.New("type mismatch")
	// ErrNoSuchKey is returned by [DefinitionOf] when no policy setting
	// has been registered with the specified key.
	//
	// Until 2024-08-02, this error was also returned by a [Handler] when the specified
	// key did not have a value set. While the package maintains compatibility with this
	// usage of ErrNoSuchKey, it is recommended to return [ErrNotConfigured] from newer
	// [source.Store] implementations.
	ErrNoSuchKey = errors.New("no such key")
)

// ErrorText represents an error that occurs when reading or parsing a policy setting.
// This includes errors due to permissions issues, value type and format mismatches,
// and other platform- or source-specific errors. It does not include
// [ErrNotConfigured] and [ErrNoSuchKey], as those correspond to unconfigured
// policy settings rather than settings that cannot be read or parsed

View on GitHub (pinned to 6e0912f979)

Solutions

1. Configure the policy setting in the relevant policy source
2. Fall back to the default value when this sentinel is returned

When it happens

Trigger: Thrown at util/syspolicy/setting/errors.go:12 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tailscale/tailscale@6e0912f979 (2026-08-18). Data as JSON: /api/errors/11e86ad9618c04df. Report an issue: GitHub.