Skip to content
RealHW

Get started

RealHW supports GitLab jobs and a REST client for inspecting hardware and reserving interactive consoles.

For CLI setup, start with Set up with your agent. For CI, follow the GitLab steps below.

You do not build RealHW or run RealHW services yourself in the normal customer path. You connect a GitLab project, choose runner tags, and let RealHW place each job on matching capacity.

Start here

Section titled “Start here”
  1. Connect a GitLab project
  2. Run your first job
  3. Choose a runner
  4. Review the marker catalog
  5. Run an image workload

The model

Section titled “The model”

RealHW exposes GitLab runner tags:

  • GitLab-compatible SaaS tags such as saas-linux-medium-amd64
  • RealHW hardware markers such as gpu:nvidia, nic:tier:25g, and numa:nodes:2

GitLab uses those tags to select the RealHW project runner. RealHW then reserves matching hardware before the job starts.