Skip to content

Runtime settings

These settings live in the database and can be changed live - no service restart needed.

Edit them at /admin/runtime.

Contrast with Environment variables, which require a restart.

SettingDefaultDescription
idle_window_seconds3600Lookback window for the idle indicator. CPU, GPU, network, and HTTP/terminal activity are averaged over this window when deciding whether a workspace is idle
usage_sample_retention_hours48How long raw usage samples are kept before pruning. Minimum 25 hours; long-term data lives in daily rollups
session_retention_hours168How long expired and revoked sessions are kept before pruning. Set to 0 to disable
cgroup_v2_limits_enabledtrueWhen false, new workspace starts omit --cpus, --memory, and --cgroup-parent. Use as a quick escape hatch on a cgroup v2 host where resource enforcement causes issues
gpu_sharing_enabledtrueOperator switch for HAMi/MIG fractional GPU. It is effective only when the license permits fractional GPU and the host has HAMi or MIG support
idle_nudge_days5Number of continuous idle days before a running workspace shows an idle badge on the home page (display-only - there is no auto-stop)
server_nickname"" (falls back to the OS hostname)Admin-set display name shown in the admin UI and in crash notifications, up to 64 characters, no newlines
fileop_max_upload_bytes10737418240Maximum size for one browser file-manager upload. Larger uploads are rejected without committing a partial file
fileop_max_concurrency_global16Maximum number of concurrent file-manager helper operations across all users
fileop_max_concurrency_per_user4Maximum number of concurrent file-manager helper operations for one user
audit_log_retention_days0How long audit records are retained. 0 keeps them indefinitely; a positive value permanently removes older audit records