Skip to main content

Specifying Hardware Requirements

Not all jobs are created equal. Some jobs require more resources than others or have specific hardware requirements like GPUs. This page describes how to specify hardware requirements for your job.

Please bear in mind that each executor is implemented independently and these docs might be slightly out of date. Double check the man page for the executor you are using with bacalhau [executor] --help.

Docker Executor

The following table describes how to specify hardware requirements for the Docker executor.

--cpu0.1 (source)Job CPU cores (e.g. 500m, 2, 8)
--memory100MB (source)Job Memory requirement (e.g. 500Mb, 2Gb, 8Gb).
--gpu0 (source)Job GPU requirement (e.g. 1).

How it Works

When you specify hardware requirements, the job will be offered out to the network to see if there are any nodes that can satisfy the requirements. If there are, the job will be scheduled on the node and the executor will be started.

If there are no nodes that can satisfy the requirements, the job will wait for a node to become available, until it times out after 3 minutes.


The following limitations currently exist within Bacalhau.

  • Maximum CPU and memory limits depend on the participants in the network
  • See the dedicated page on GPUs to see GPU limitations

Also See