Get the nested VM host installer
Returns the installer that enrolls a virtual machine with nested virtualization as a VM host, an option OpenRelay turns on per provider organization. The machine enrolls as a qemu VM host and rents VMs from inside it. The route is off for every provider unless OpenRelay has turned the nested VM host option on for the organization; without it the route answers 403 NESTED_VM_NOT_ENABLED. With a bearer org API key it mints a fresh provisioning token (24 hours, any number of nodes); with ?token=otk_… it self-auths and embeds that token instead. name only applies when minting. Before it changes anything, the installer checks that the machine is a guest with /dev/kvm and a CPU that exposes hardware virtualization and, when it has GPUs, that every GPU is NVIDIA and sits behind a virtual IOMMU with interrupt remapping. It refuses a machine that fails a check and names the fix. A machine that passes enrolls as a qemu VM host with its GPUs on VFIO passthrough. A rental on such a host is a community or spot VM, or a CPU VM; a verified VM never runs on one.
Required permission
With an API key: checked against the provider.write permission for the resource it acts on. See Permissions for the roles and API key permissions that include it.
apiKeyAuthorizationBearer <token>OpenRelay API key. Send it as Authorization: Bearer or_… (legacy vl_… keys still work).
token?stringPre-minted provisioning token (otk_…); replaces bearer auth
name?stringToken label; mint path only
The installer script (contains a secret provisioning token, never cached)
response?stringtext/x-shellscriptcurl -X GET 'https://api.openrelay.inc/v1/provider/bootstrap/nested-vm'"string"Get the one-command node installer GET
Returns a self-contained shell installer, run on the host with curl piped to sudo bash, that enrolls the machine as a provider node in the community pool. With a bearer org API key it mints a fresh provisioning token (24 hours, any number of nodes); with ?token=otk_… (e.g. minted from the dashboard) it self-auths and embeds that token instead. name only applies when minting (the token already carries it). The runtime is detected on the box, not chosen here: a bare metal host enrolls as a qemu VM host with VFIO passthrough, and a virtualised guest enrolls as a runc pod host on its native NVIDIA or AMD driver.
Get the interruptible container installer GET
Returns a POSIX sh installer that enrolls the container it runs in as an interruptible node. It needs no root, systemd or capabilities to run. Run it inside the container as `curl -fsSL "<url>" | sh` or `wget -qO- "<url>" | sh`. It downloads the interruptible agent for the container's architecture, verifies its sha256, and runs it; the agent enrolls the container and detaches. The token must be an interruptible one (orl provider provisioning-token create --class interruptible).