@machine-core

Settings

machine-core's 26 platform settings and its environment-only infrastructure variables.

machine-core declares 26 platform settings (Config → Platform Settings, category Machine), read at the moment they apply, so an admin edit needs no restart. Some apply on the host at the next call, check or spawn; the rest are snapshotted into a container when it is created, so a running desktop keeps the caps it was born with until it is replaced. Running the desktops — the image, the Docker socket, networking, storage and the lifecycle in operation — is covered in deployment.

Desktop and lifecycle

Five settings also read an environment variable when unset.

KeyEnvironment fallbackDefaultApplies
machineImageNEURALIS_MACHINE_IMAGEneuralisapp/webtop-ubuntu-xfce:<version> (the release's own version)Next spawn — running machines keep their image
machineDesktopVariantNEURALIS_MACHINE_DESKTOP_VARIANTubuntu-xfceNext spawn
machineIdleMinutesNEURALIS_MACHINE_IDLE_MINUTES30 (1–1440)Next idle check — an idle machine is stopped, never deleted
machineRecordingTtlHoursNEURALIS_MACHINE_RECORDING_TTL_HOURS24 (0–720)Next sweep — retention for recordings; 0 disables the sweep
machineKeyComboExceptionsNEURALIS_MACHINE_KEY_COMBO_EXCEPTIONS(none)Comma-separated combos exempted from the desktop-key denylist. The host check reads it live; a machine's own check takes it when the machine is created, so re-create an existing machine after changing it
machineSpawnSmokeSeconds—60 (15–300)Next spawn — the browser and agent readiness window

Tool limits

KeyDefaultRangeApplies
machineBatchMaxSteps501–50Next call — child actions per machine_use batch
machineBatchBudgetMs6000005000–1500000Next call — wall-clock budget for one batch
machineReadMaxCharsDefault8000500–120000Next read — default cap when maxChars is omitted
machineReadDomMaxChars120001000–120000Next read — HTML/DOM truncation cap
machineNavTimeoutMs600001000–60000Next call — default goto navigation timeout
machineActionTimeoutMs30000500–60000Next call — default actionability/wait timeout
machineExecOutputMaxChars80001000–20000Next call — model-visible Webtop shell stdout cap
machineRecordMaxMs1200001000–300000Next spawn — recording duration cap
machineRecordMaxMb251–500Next spawn — finished-recording size cap
machineScreenshotMaxMb81–64Next spawn — desktop screenshot payload cap
machineExecTimeoutCeilingMs18000005000–1800000Next spawn — ceiling over an explicit execute.timeout
machineDetachedLifetimeMaxMs8640000060000–86400000Next spawn — how long one background command may run before the desktop kills it
machineDetachedRunsMax161–64Next spawn — background commands one machine may run at once
machineExecOutputMaxBytes13107216384–1048576Next spawn — in-container stdout/stderr accumulation cap
machineFsReadMaxBytes209715265536–16777216Next spawn — cap on one filesystem read
machineSidecarBodyLimitMb41–64Next spawn — request-body cap, so the largest file writable into the desktop

Stream

KeyDefaultApplies
machineStreamCssCursortrueNext spawn — the browser draws the mouse pointer instead of the server compositing it into the video
machineStreamFramerate(empty)Next spawn — framerate, as a range (24-60) or a fixed value
machineStreamH264Crf(empty)Next spawn — video quality factor for every encoder, range or fixed (lower is better quality)
machineStreamEncoder(empty)Next spawn — comma-separated list of video encoders the desktop may offer

Leaving the last three empty keeps the image's own range AND the picker inside the desktop's own settings panel, while a fixed value locks that picker to what you set. Empty is the setting that leaves the choice with the person watching the screen; set one only to pin every session, for example to cap bandwidth. The value is passed through verbatim and validated by the desktop image, which logs an invalid value and falls back to its own default.

Environment-only infrastructure

Socket, ports, network and sandbox settings are environment-only by design.

VariableDefaultPurpose
NEURALIS_MACHINE_DOCKER_SOCKET/var/run/docker.sockDocker daemon socket
NEURALIS_MACHINE_SIDECAR_PORT9400In-container machine-agent HTTP port
NEURALIS_MACHINE_SECCOMP_UNCONFINEDfalseRun sessions with seccomp=unconfined (Chromium compatibility on legacy kernels)
NEURALIS_MACHINE_SHARED_NETWORK(detected)Override the user-defined Docker network shared with Neuralis
NEURALIS_MACHINE_HOST_ADDRESSlocalhostHost address used in published-port mode (no shared network)

On this page