System Configuration

Provides system-wide configuration options for controlling sessions, instances, client-server communication, and performance settings. Defaults are automatically initialized.

Apply

Configuration applied to the doors.Router with doors.UseSystemConf mod

router.Use(doors.UseSystemConf(doors.SystemConf{
	SessionInstanceLimit: 6,
}))

Fields

type SystemConf struct {
	SessionInstanceLimit     int
	SessionTTL							 time.Duration
	InstanceGoroutineLimit   int
	InstanceTTL              time.Duration
	ServerCacheControl       string
	ServerDisableGzip        bool
	DisconnectHiddenTimer    time.Duration
	RequestTimeout           time.Duration
	OptimisticSync           bool
	SolitairePing            time.Duration
	SolitaireSyncTimeout     time.Duration
	SolitaireRollTimeout     time.Duration
	SolitaireFlushSizeLimit  int
	SolitaireFlushTimeout    time.Duration
	SolitaireQueue           int
	SolitairePending         int
}

If you’d like certain options configurable per instance or dynamicaly, please open a GitHub issue.

Resource Control

Key settings to understand:

• SessionInstanceLimit — Max page instances per session. Oldest inactive suspended if exceeded. Default: 12

• SessionTTL — Session lifetime policy. Default: 0

Behavior at 0: session ends when no instances remain, and the session cookie expires when the browser closes.

• InstanceGoroutineLimit — Max goroutines per instance for rendering and reactivity. Default: 16

• InstanceTTL — Lifetime of inactive instances before cleanup. Default: 40minutes or ≥ 2× RequestTimeout

• DisconnectHiddenTimer — Time hidden/background tabs stay connected. Default: InstanceTTL ÷ 2

Solitaire Protocol (synchronization)

Control Synchronization Issues

• SolitaireSyncTimeout — Max pending duration of a server→client sync calls; exceeding kills instance. Default: InstanceTTL
• SolitaireQueue — Max queued server→client sync calls; exceeding kills instance. Default: 1024
• SolitairePending — Max unresolved server→client sync calls; throttles sending when reached. Default: 256

Control Network Behavior

• SolitairePing — Max idle time before rolling the request. Default: 15s
• SolitaireRollTimeout — How long an active sync connection lasts before rolling (affects if sync queue is long). Default: 1s
• SolitaireFlushSizeLimit — Max written bytes before forcing a flush. Default: 32 KB
• SolitaireFlushTimeout — Max delay before forcing a flush. Default: 30ms

Other

• OptimisticSync — Makes all system front-end sync resolve optimistically on successful flush without front-end reporting, leading to early indication canceling. Can improve or hurt UX.
• RequestTimeout — Max duration of a client-server request (hook). Default: 30s
• ServerCacheControl - Cache control header value for JS and CSS resources prepared by the framework. Default: public, max-age=31536000, immutable
• ServerDisableGzip — Disables gzip compression when true. Applies to HTML, JS, and CSS. Default: false.