# Process Host

_Path: en/system/process-host_

## Table of Contents

- Process Host

## Content

# Process Host


Process hosts manage Lua process execution using a work-stealing scheduler.

<note>
Each host schedules processes independently. Load is not distributed between hosts automatically.
</note>



## Entry Kind


| Kind | Description |
|------|-------------|
| `process.host` | Process execution host with scheduler |



## Configuration


```yaml
- name: main_host
  kind: process.host
  host:
    workers: 8
    queue_size: 1024
    local_queue_size: 256
  lifecycle:
    auto_start: true
```

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `workers` | int | NumCPU | Worker goroutines |
| `queue_size` | int | 1024 | Global queue capacity |
| `local_queue_size` | int | 256 | Per-worker local deque size |



## Scheduler


The scheduler uses work-stealing: each worker has a local deque, and idle workers steal from the global queue or other workers. This balances load automatically.

- **Workers** execute processes concurrently
- **Global queue** holds pending processes when all workers are busy
- **Local queues** reduce contention by keeping work close to workers



## Process Types


Process hosts execute entries of these kinds:

| Kind | Description |
|------|-------------|
| `process.lua` | Source-based Lua process |
| `process.lua.bc` | Precompiled Lua bytecode |
| `process.wasm` | WebAssembly process (experimental) |

Processes run independently with their own context, communicate via messages, and are supervised for fault tolerance.



## See Also


- [Process Module](lua/core/process.md) - Spawn and manage processes from Lua
- [WASM Processes](wasm/processes.md) - Configuring `process.wasm` entries
- [Process Model](concepts/process-model.md) - Lifecycle and supervision concepts
- [Supervision](guides/supervision.md) - Building supervision trees



## Navigation

Previous: Workflows (temporal/workflows)
Next: Process Groups (system/process-groups)