Runtime settings
These settings live in the database and can be changed live - no service restart needed.
Edit them from admin’s System area (/admin/runtime): server_nickname,
cgroup_v2_limits_enabled, and gpu_sharing_enabled are in its Common settings section (each
shown with an Effective/Not effective pill); everything else is in the searchable, individually
resettable Advanced overrides section.
Contrast with Environment variables, which require a restart.
Settings reference
Section titled “Settings reference”| Setting | Default | Admin UI section | Description |
|---|---|---|---|
idle_window_seconds | 3600 | Advanced overrides | Lookback window for the idle indicator, maximum 9223372036. CPU, GPU, network, and HTTP/terminal activity are averaged over this window when deciding whether a workspace is idle |
usage_sample_retention_hours | 48 | Advanced overrides | How long raw usage samples are kept before pruning. Minimum 25 hours, maximum 2562047, and must be at least ceil(idle_window_seconds / 3600) + 1; long-term data lives in daily rollups |
session_retention_hours | 168 | Advanced overrides | How long expired and revoked sessions are kept before pruning, maximum 2562047. Set to 0 to disable |
cgroup_v2_limits_enabled | true | Common settings | When 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_enabled | true | Common settings | Operator 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_days | 5 | Advanced overrides | Number of continuous idle days before a running workspace shows an idle badge on the home page, maximum 106751 (display-only - there is no auto-stop) |
server_nickname | "" (falls back to the OS hostname) | Common settings | Admin-set display name shown in the admin UI and in crash notifications, up to 64 characters, no newlines |
fileop_max_upload_bytes | 10737418240 | Advanced overrides | Maximum size for one browser file-manager upload. Larger uploads are rejected without committing a partial file |
fileop_max_concurrency_global | 16 | Advanced overrides | Maximum number of concurrent file-manager helper operations across all users |
fileop_max_concurrency_per_user | 4 | Advanced overrides | Maximum number of concurrent file-manager helper operations for one user |
audit_log_retention_days | 0 | Advanced overrides | How long audit records are retained, maximum 106751. 0 keeps them indefinitely; a positive value permanently removes older audit records |