Name
nebius ai create
Interactively creates a Serverless AI job, endpoint, or Devlab.
Use nebius ai <type> create for scripts and explicit configurations.
Options
--args (string)
Override container arguments.
--auth (string)
Authentication method, default is none.
A value must be one of:
nonetoken
--auth-token-secret (string)
MysteryBox secret selector with an AUTH_TOKEN payload key for the bearer token. Selector can be a secret name, secret ID, version ID, or SECRET_ID@VERSION_ID.
--container-command (string)
Override container entrypoint command.
--container-port (string array)
Port to expose as HOST[:CONTAINER][/http|tcp|udp] (default protocol http; repeatable). For endpoints, each HTTP port is reachable over a managed https:// URL (gRPC works over the same URL) and each TCP port over a tls://HOST:443 URL; UDP ports get no managed URL.
--disk-size (string)
Disk size (e.g., 100Gi, 500Gi, 1Ti), default is 250Gi.
--env (string array)
Environment variable in KEY=VALUE format (repeatable).
--env-secret (string array)
Environment variable from MysteryBox in KEY=SECRET_SELECTOR format (repeatable). SECRET_SELECTOR can be a secret name, secret ID, version ID, or SECRET_ID@VERSION_ID.
--follows-spot-price (bool)
The preemptible VM accepts the current spot price. Requires —preemptible.
Mutually exclusive with: --on-demand, --spot-pricing-policy-id.
--image (string)
Container image reference in the registry/path:tag or registry/path@digest format.
--inject-file (string array)
Inject a local config file into the container at LOCAL_PATH:CONTAINER_PATH (repeatable). CONTAINER_PATH must be an absolute path; the file is read-only inside the container and limited to 64 KiB.
--input (string array)
Template input field value in KEY=VALUE format (repeatable). Requires —template.
--name (string)
Application name.
--on-demand (bool)
A regular, non-preemptible VM. Cannot be combined with —preemptible.
Mutually exclusive with: --follows-spot-price, --spot-pricing-policy-id.
--parent-id (string)
Parent ID (if not specified, it will be taken from the CLI profile).
--platform (string)
Platform of compute resources (e.g. gpu-h100-sxm, gpu-l40s-d), default is gpu-h100-sxm in eu-north1 and gpu-h200-sxm elsewhere.
--preemptible (bool)
Use a preemptible VM (cheaper but can be stopped by the platform at any time). Requires —follows-spot-price or —spot-pricing-policy-id.
--preset (string)
Preset for selected platform (e.g. 1gpu-16vcpu-200gb), default is minimum available preset for the platform.
--primary-route-port (int)
Container port that serves the primary web UI behind the managed HTTPS route. Required without —template.
--public (bool)
Assign a public IP to the workload (default false). For endpoints this is independent of the managed https:// and tls:// URLs, which are provided regardless of this flag.
--registry-password (string)
Container registry password.
--registry-secret (string)
MysteryBox secret selector with REGISTRY_USERNAME and REGISTRY_PASSWORD payload keys. Selector can be a secret name, secret ID, version ID, or SECRET_ID@VERSION_ID.
--registry-username (string)
Container registry username.
--restart-policy (string)
Restart policy, default is never.
A value must be one of:
neveron-failure
--shm-size (string)
Size of /dev/shm (e.g., 64Mi, 128Mi, 1Gi), default - 16Gi for GPU platforms, 0 for CPU.
--spot-pricing-policy-id (string)
PricingPolicy ID used as the maximum agreed price for the preemptible VM. Requires —preemptible.
Mutually exclusive with: --on-demand, --follows-spot-price.
--ssh-key (string array)
Public key authorized for SSH access to the workload (repeatable). For jobs, setting SSH keys also assigns a public IPv4 address, which counts against your public IPv4 quota.
--subnet-id (string)
Subnet ID (default: the project’s default subnet in the workload region).
--template (string)
Devlab template name (e.g. jupyter) or ID (vmapptemplate-…). Mutually exclusive with —image.
--timeout (duration: 2h30m10s)
Job timeout (min 5m, max 168h, default 24h). Checked asynchronously.
--token (string)
Token used for endpoint authentication (if —auth=token and neither —token nor —token-secret is set, a random token is generated).
--token-secret (string)
MysteryBox secret selector with AUTH_TOKEN payload key. Selector can be a secret name, secret ID, version ID, or SECRET_ID@VERSION_ID.
--type (string)
Workload type: job, endpoint, or devlab. Select a type when omitted.
--volume (string array)
Volume mount in SOURCE:CONTAINER_PATH[:MODE] or s3://BUCKET:/container_path[:MODE[:PROFILE]] format. MODE: rw, ro (default: rw). PROFILE: AWS credentials profile (default: ‘default’). For S3 MysteryBox auth use PROFILE@SECRET_SELECTOR, where SECRET_SELECTOR can be a secret name, secret ID, version ID, or SECRET_ID@VERSION_ID (repeatable).
--working-dir (string)
Working directory (absolute path).
--workspace-path (string)
Absolute path of the persistent workspace inside the container. Defaults to /workspace without a template, or the template default when —template is set.
Global Options
-h, --help (bool)
Show this message.
-p, --profile (string)
Set a profile for interacting with the cloud.
--format (string)
Output format. Supported values: yaml|json|jsonpath|table|text.
-f, --file (string)
Input file. For ‘update’ commands automatically set —full=true.
-c, --config (string)
Provide path to config file.
--debug (bool)
Write debug logs to stderr. Commands save debug logs in the config directory under logs/, except help and shell completion.
-I, --impersonate-service-account-id (string)
Impersonate into the service account and use its token for a command.
--color (bool)
Enable colored output.
--no-browser (bool)
Do not open browser automatically on auth.
--insecure (bool)
Disable transport security.
--auth-timeout (duration: 2h30m10s)
Set the timeout for the request including authentication process, default is 15m0s.
--per-retry-timeout (duration: 2h30m10s)
Set the timeout for each retry attempt, default is 20s.
--retries (uint)
Set the number of retry attempts, 1 is disable retries, default is 3.
--no-check-update (bool)
Suppress check for updates.
--no-progress (bool)
Suppress progress indicators and spinners.