When deploying with NixOS, NixOps or nix-darwin you should use the module
documentation instead, or skip ahead to read about less frequently used options
to use with
The configuration format for the agent is TOML markup.
Its location can be specified by invoking
hercules-ci-agent --config agent.toml. Alternatively, the NixOS and nix-darwin module can generate this file for you. See also the setup guide.
agent.toml looks as follows:
baseDirectory = "/var/lib/hercules-ci-agent" concurrentTasks = 4
|If you are deploying an agent, the guide is a better starting point.|
Directory with all the agent state: secrets, work, etc.
Optional. Defaults to 4.
Combined number of workers to use for building and evaluating Nix derivations.
The optimal value depends on the resource consumption characteristics of your workload, including memory usage and in-task parallelism. This is typically determined empirically.
Optional. Defaults to
This is the default directory to look for statically configured secrets like clusterJoinTokenPath.