# Run with hugepages

> Reserve hugepages for a GitLab job.

Source: https://docs.realhw.dev/guides/run-with-hugepages/
Documentation index: https://docs.realhw.dev/llms.txt

Set `HW_HUGEPAGE_BYTES` for jobs that need hugepage-backed memory.

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

Use `HW_NUMA_POLICY` when hugepage locality matters.