> ## Documentation Index
> Fetch the complete documentation index at: https://solo-09d10f60.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Worker configuration

> Configure worker preflight, evidence sync, and stale-process reaping.

# Worker configuration

A worker is the machine that runs agent jobs and exposes a worker-gate API to the control plane. In local development, the control and worker roles can point at the same `127.0.0.1:8787` app.
For current runtime topology and worker-gate boundaries, see
[current runtime snapshot](/current-runtime-snapshot).

## Connection fields

* `worker_wake_gate_url` — base URL for the worker-gate API. The field name remains for compatibility.
* `worker_wake_gate_bearer_token` — bearer token the control plane uses when calling the worker.
* `worker_targets` — named worker endpoints with per-target URLs, tokens, roles, and optional memory floors.
* `workload_machine_targets` — maps workload classes such as `cpu_only` and `gpu_required` to a `worker_targets` key.

For local development, set both `worker_wake_gate_url` and `completion_callback_url` to the local service. For production with multiple workers, configure `worker_targets` and route dispatches through `workload_machine_targets` or explicit `machine_target` in preflight requests.

## Evidence sync fields

* `paper_evidence_sync_enabled`
* `paper_evidence_sync_ssh_host`
* `paper_evidence_sync_remote_root`
* `paper_evidence_sync_timeout_sec`

Enable evidence sync only after you know the control service user can read the worker project artifacts it needs. If sync fails or artifacts are missing, generated paper records should be treated as incomplete.

## Stale-process reaper fields

* `stale_project_process_reaper_enabled`
* `stale_project_process_grace_sec`
* `stale_project_process_term_grace_sec`
* `stale_project_process_command_markers`

Default markers include common local inference/server commands such as `llama-cli`, `llama-server`, `vllm`, and `sglang`. Keep markers specific to avoid terminating unrelated processes.

## Minimal worker run

```bash theme={null}
scripts/install-worker.sh
ENOCH_CONFIG=$HOME/.config/enoch-worker/config.json \
  uv run uvicorn enoch_control_plane.app:app --host 0.0.0.0 --port 8787
```

## Verify from the control VM

```bash theme={null}
curl -fsS -H "Authorization: Bearer $ENOCH_CONTROL_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"wake_gate_url":"http://<worker>:8787","bearer_token":"<worker-token>","require_paused":false,"strict":false}' \
  "$ENOCH_BASE_URL/control/api/preflight" | python3 -m json.tool
```