Choose the source boundary
Open Remote build runner from the Build menu. A public Git repository can run on marketplace capacity or a private cluster. A ZIP source archive is limited to a private cluster so it is only dispatched to machines inside the cluster boundary.
- Public repository: enter a cloneable HTTPS Git URL.
- Private source: create or select a private cluster, then upload a .zip archive.
- Private Git credentials and GitHub App installation are not part of runner v1.
Define the commands
Choose the Node or Python preset, or enter custom shell commands with one command per line. The remote executor runs them in order and stops after the first non-zero exit.
npm ci
npm test
npm run buildChoose capacity and limits
Marketplace mode asks the scheduler for an eligible provider. Private cluster mode keeps the run inside a cluster you can operate. Set timeout, minimum CPU, minimum RAM, and an optional marketplace price ceiling before submitting.
Follow and control the run
- Queued means the scheduler is finding eligible capacity.
- Preparing means a provider has claimed the job and is acquiring source.
- Executing shows output emitted by the isolated build container.
- Cancel a non-terminal run or retry a failed or cancelled run from the detail panel.
Retrieve the result
A successful run packages the resulting workspace as a downloadable archive. The run keeps terminal status, provider logs, attempts, duration, cost, execution receipt, and artifact metadata in the existing PlanetNodes job record.
Security model
The provider agent acquires public Git source before launching the workload container. The workload executes with network access disabled and resource limits enforced. A provider controls the host and cannot be treated as a cryptographic confidentiality boundary; use only trusted private-cluster machines for source that must not be exposed to an independent provider.