api / interfaces / BootOptions
Interface: BootOptions
Properties
| Property | Modifier | Type | Description |
|---|---|---|---|
backend? | readonly | RuntimeBackendKind | Runtime backend selection. - browser runs inside browser workers and is the default. - server starts a managed server runtime immediately. - auto starts in the browser and promotes to the server backend for commands that require it, such as uv, native tools, or unsupported Python package stacks. |
brokerUrl? | readonly | string | URL | Runtime broker base URL for server-backed sessions. Hosted projects normally receive this from the runtime boot service. |
limits? | readonly | Partial<RuntimeLimits> | - |
nativeInstallMode? | readonly | NativeInstallMode | - |
nativePackagePolicy? | readonly | "error" | "replace" | - |
nativePackageReplacements? | readonly | Readonly<Record<string, NativePackageReplacement>> | - |
onDiagnostic? | readonly | (event) => void | - |
packageRegistryUrl? | readonly | string | - |
persistenceHandoff? | readonly | "wait" | "fail-fast" | - |
persistenceKey? | readonly | string | - |
persistOnTeardown? | readonly | boolean | - |
previewOriginTemplate? | readonly | string | Isolated preview origin template. Hosted projects normally receive https://{previewSessionId}.preview.verklet.com from the runtime boot service. Custom templates must contain {previewSessionId} and resolve to an HTTP(S) origin. |
projectId | readonly | string | Public project ID from a Verklet account. Create an account, select or create an organization, then copy the generated prj_... ID from /account. Unknown project IDs are rejected by the hosted boot service. |
python? | readonly | PythonRuntimeOptions | Browser Python configuration. The default keeps backend: 'auto' browser-first: supported Python runs in Pyodide and unsupported workloads promote to the server backend when fallback is enabled. |
requireWasm? | readonly | boolean | - |
runtimeConfigUrl? | readonly | string | false | URL | - |
runtimeId? | readonly | string | - |
server? | readonly | ServerBackendOptions | Server-backend options used when backend is server or auto. |
serviceWorker? | readonly | false | PreviewServiceWorkerOptions | - |
wasmExecutionPolicy? | readonly | WasmExecutionPolicy | - |