On-prem CLI

Install and remove on-prem training workers from your terminal. Commands match the snippets on On-prem training cluster → class row → Config → Arena CLI (recommended).

Prerequisites

  • Arena CLI installed (pip install "agilerl[arena]")

  • arena login or ARENA_API_KEY (Authentication)

  • Enterprise organization

  • One install target per cluster — Docker Swarm or Helm on Kubernetes, not both:

    • Swarm: SSH to manager and worker hosts from the machine running the command

    • Helm: kubectl context for the target cluster

Install

arena login
arena on-prem install MY-CLASS --setup-type dockerSwarm \
  --manager MANAGER_HOST --workers gpu1.example.com,gpu2.example.com

Helm (local kubectl):

arena on-prem install MY-CLASS --setup-type helm

Replace MY-CLASS with the resource class Name from the training cluster table.

From the Config panel: the class already exists; the command installs workers for that class.

From your terminal only: arena on-prem install NEW-NAME can enable the on-prem provider and create the class when missing, then download the bundle and install. Set worker sizing afterward in the UI or with CLI class update commands if your install flow requires it.

Swarm install over SSH can install Docker on fresh nodes (including reboot when required). Helm runs ./setup.sh against your current kube context.

Down

Stop workloads without removing the deployment definition:

arena on-prem down MY-CLASS --setup-type dockerSwarm --manager MANAGER_HOST
arena on-prem down MY-CLASS --setup-type helm

dockerSwarm — scales every service in the stack to zero replicas; the stack remains on the manager.

helm — scales deployments to zero replicas; the Helm release remains. Release and namespace come from the deployment bundle (override with RELEASE_NAME / NAMESPACE env vars when set in the bundle).

To bring workloads back, re-run arena on-prem install with the same flags.

Teardown

Remove the deployment (stack or Helm release):

arena on-prem teardown MY-CLASS --setup-type dockerSwarm --manager MANAGER_HOST
arena on-prem teardown MY-CLASS --setup-type helm

Use the same --setup-type as install. Swarm teardown needs --manager.

Removes the deployment only — not a full reversal of install (Docker, NVIDIA, and the Arena resource class remain). With --leave-swarm, pass --workers on multi-node clusters so every node can leave the Swarm.