Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

runtimeconfig

package

Go to main page

Versions in this module

v0

v0.0.14

Sep 1, 2026

v0.0.13

Aug 26, 2026

Changes in this version

type MCPConfig

+ StdioSendInitializedNotification bool

v0.0.13-dev

Aug 20, 2026

v0.0.12

Aug 20, 2026

Changes in this version

+ const ConfigEnvName

+ const DefaultAdminUILogBufferEvents

+ const DefaultControlPlaneBaseURL

+ const DefaultHarpoonMaxRedirects

+ const DefaultHarpoonMaxResponseBytes

+ const DefaultProxyCheckInterval

+ const ProfileDirEnvName

+ const ProfileEnvName

+ const ProfileFileEnvName

+ func BuildTLSBundle(fs *pflag.FlagSet, lookupEnv func(string) (string, bool)) (*tlsconfig.Bundle, error)

+ func ControlPlaneURLPathRaw(fs *pflag.FlagSet, lookupEnv func(string) (string, bool)) string

+ func DefaultProfileDir(lookupEnv func(string) (string, bool)) (string, error)

+ func EnvProxyConfigured(lookupEnv func(string) (string, bool)) bool

+ func LoadFullFromFlagSet(fs *pflag.FlagSet, lookupEnv func(string) (string, bool)) (*Config, CloudflaredSettings, LoadContext, error)

+ func NormalizeControlPlaneURLPath(raw string) (string, error)

+ func NormalizeExtraHeaders(source string, headers map[string]string) (map[string]string, error)

+ func ParseProxyCheckInterval(raw string) (time.Duration, error)

+ func ParseURL(raw string) (*url.URL, error)

+ func ProfilePath(name string, explicitDir string, lookupEnv func(string) (string, bool)) (string, string, error)

+ func ProxyLogFields(proxyURL *url.URL, source ProxySource) []any

+ func RedactProxyURL(proxyURL *url.URL) string

+ func RegisterFlags(fs *pflag.FlagSet, flavor Flavor)

+ func RegisterTLSFlags(fs *pflag.FlagSet)

+ func ResolveControlPlanePath(baseURL *url.URL, urlPath, routePath string) *url.URL

+ func ResolveProfileDir(explicitDir string, lookupEnv func(string) (string, bool)) (string, error)

+ func ValidateControlPlaneAPIKey(key string) error

+ func ValidateFullProfileBytes(path string, data []byte) error

+ func ValidateFullProfileFile(path string) error

+ func ValidateProfileBytes(path string, data []byte) error

+ func ValidateProfileFile(path string) error

+ func ValidateProfileName(name string) error

+ func ValidateTunnelID(tunnelID string) error

+ func WriteUsage(fs *pflag.FlagSet, w io.Writer)

+ type CloudflaredConfig struct

+ Cloudflared CloudflaredSettings

+ Runtime Config

+ func LoadCloudflaredFromFlagSet(fs *pflag.FlagSet, lookupEnv func(string) (string, bool)) (*CloudflaredConfig, error)

+ type CloudflaredSettings struct

+ Managed bool

+ Path string

+ ReadyTimeout time.Duration

+ Token string

+ func (c CloudflaredSettings) Enabled() bool

+ type Config struct

+ ControlPlane ControlPlaneConfig

+ Harpoon HarpoonConfig

+ Health HealthConfig

+ Logging LoggingConfig

+ MCP MCPConfig

+ Process ProcessConfig

+ Runtime RuntimeConfig

+ TLS *tlsconfig.Bundle

+ func Load(args []string, flavor Flavor, lookupEnv func(string) (string, bool)) (*Config, error)

+ func LoadFromFlagSet(fs *pflag.FlagSet, lookupEnv func(string) (string, bool)) (*Config, error)

+ type ConfigSource struct

+ Path string

+ ProfileDir string

+ ProfileFile bool

+ ProfileName string

+ ProfilePath string

+ func ResolveConfigSource(fs *pflag.FlagSet, lookupEnv func(string) (string, bool)) (ConfigSource, error)

+ type ControlPlaneConfig struct

+ APIKey string

+ BaseURL *url.URL

+ ClientCertificate *tlsconfig.ClientCertificate

+ ExtraHeaders map[string]string

+ HTTPProxy *url.URL

+ HTTPProxySource ProxySource

+ MCPServerInfoHeader func() (string, error)

+ MaxInFlightRequests int

+ OrganizationID string

+ PollBackoffMax time.Duration

+ PollBackoffMin time.Duration

+ PollChannels []types.Channel

+ PollChannelsConfigured bool

+ PollDeadlineGuardrail time.Duration

+ PollTimeout time.Duration

+ TunnelID types.TunnelID

+ URLPath string

+ UnixSocketPath string

+ func (c ControlPlaneConfig) PollDeadlineGuardrailOrDefault() time.Duration

+ func (c ControlPlaneConfig) PollDeadlineTimeoutOrDefault() time.Duration

+ func (c ControlPlaneConfig) PollTimeoutOrDefault() time.Duration

+ type Flavor string

+ const FlavorFull

+ const FlavorRuntime

+ const FlavorRuntimeCloudflared

+ type HarpoonConfig struct

+ AdditionalTransports []HarpoonTransportKind

+ AllowPlaintextHTTP bool

+ HTTPProxy *url.URL

+ HTTPProxySource ProxySource

+ HostClassifier HarpoonHostClassifierConfig

+ MaxRedirects int

+ MaxResponseBytes int

+ Targets []HarpoonTarget

+ func (h HarpoonConfig) AdditionalTransportEnabled(kind HarpoonTransportKind) bool

+ type HarpoonHostClassifierConfig struct

+ IncludeLoopback bool

+ IncludePrivate bool

+ IncludeRegex []string

+ IncludeSuffix []string

+ type HarpoonTarget struct

+ BaseURL *url.URL

+ Description string

+ Label string

+ UnixSocketPath string

+ type HarpoonTransportKind string

+ const HarpoonTransportHTTPStreamable

+ type HealthConfig struct

+ ListenAddr string

+ URLFile string

+ UnixSocket string

+ type LoadContext struct

+ LookupEnv func(string) (string, bool)

+ RawConfig []byte

+ Source ConfigSource

+ type LogFormat int

+ const LogFormatJSON

+ const LogFormatStructText

+ const LogFormatUnset

+ func ParseLogFormat(raw string) (LogFormat, error)

+ func (f LogFormat) String() string

+ type LoggingConfig struct

+ File string

+ Format LogFormat

+ HTTPRawUnsafe bool

+ Level slog.Level

+ type MCPChannelBinding struct

+ Channel types.Channel

+ ClientCertificate *tlsconfig.ClientCertificate

+ Command string

+ CommandArgs []string

+ HTTPProxy *url.URL

+ HTTPProxySource ProxySource

+ ServerURL *url.URL

+ TransportKind MCPTransportKind

+ UnixSocketPath string

+ type MCPConfig struct

+ AllowNoMain bool

+ ChannelBindings []MCPChannelBinding

+ ClientCertificate *tlsconfig.ClientCertificate

+ Command string

+ CommandArgs []string

+ ConnectionMaxTTL time.Duration

+ DiscoveryExtraHeaders map[string]string

+ ExtraHeaders map[string]string

+ HTTPProxy *url.URL

+ HTTPProxySource ProxySource

+ MaxConcurrentRequests int

+ ServerURL *url.URL

+ StartupWaitTimeout time.Duration

+ TransportKind MCPTransportKind

+ UnixSocketPath string

+ func (c *MCPConfig) ChannelBindingFor(channel types.Channel) *MCPChannelBinding

+ func (c *MCPConfig) MainChannelBinding() *MCPChannelBinding

+ type MCPTransportKind string

+ const MCPTransportHTTPStreamable

+ const MCPTransportInMemory

+ const MCPTransportStdio

+ type ProcessConfig struct

+ PIDFile string

+ type ProxySource string

+ const ProxySourceEnvironment

+ const ProxySourceIgnored

+ const ProxySourceNone

+ func (s ProxySource) String() string

+ type RuntimeConfig struct

+ ConfigFile string

+ ConfigFileContents []byte

+ ProfileDir string

+ ProfileFile bool

+ ProfileName string

+ ProfilePath string