# NUMA and hugepages

> Select NUMA topology and reserve hugepages.

Source: https://docs.realhw.dev/hardware-markers/numa-and-hugepages/
Documentation index: https://docs.realhw.dev/llms.txt

Use NUMA markers when a job needs a host with a specific topology.

```yaml
numa-tests:
  tags:
    - saas-linux-large-amd64
    - numa:nodes:2
  variables:
    HW_NUMA_POLICY: "single-node"
  script:
    - ./run-numa-tests.sh
```

Use hugepage variables when the job must reserve hugepages:

```yaml
hugepage-tests:
  tags:
    - saas-linux-large-amd64
  variables:
    HW_HUGEPAGE_BYTES: "1073741824"
    HW_NUMA_POLICY: "single-node"
  script:
    - ./run-hugepage-tests.sh
```