XTLS/Xray-core · error

failed to reload environment settings

Error message

failed to reload environment settings

What it means

Error "failed to reload environment settings" thrown in XTLS/Xray-core.

Source

Thrown at core/xray.go:191

	}

	return server, nil
}

func NewWithContext(ctx context.Context, config *Config) (*Instance, error) {
	server := &Instance{ctx: ctx}

	done, err := initInstanceWithConfig(config, server)
	if done {
		return nil, err
	}

	return server, nil
}

func initInstanceWithConfig(config *Config, server *Instance) (bool, error) {
	if err := platform.ReloadEnvSettings(); err != nil {
		return true, errors.New("failed to reload environment settings").Base(err)
	}
	server.ctx = context.WithValue(server.ctx, "cone",
		platform.NewEnvFlag(platform.UseCone).GetValue(func() string { return "" }) != "true")

	for _, appSettings := range config.App {
		settings, err := appSettings.GetInstance()
		if err != nil {
			return true, err
		}
		obj, err := CreateObject(server, settings)
		if err != nil {
			return true, err
		}
		if feature, ok := obj.(features.Feature); ok {
			if err := server.AddFeature(feature); err != nil {
				return true, err
			}
		}

View on GitHub (pinned to 7d214f8b09)

When it happens

Trigger: Thrown at core/xray.go:191 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of XTLS/Xray-core@7d214f8b09 (2026-08-15). Data as JSON: /api/errors/159fed0e19bc7bad. Report an issue: GitHub.