Skip to main content

​
Name

nebius ai endpoint create

Creates an endpoint.

​
Synopsis

nebius ai endpoint create
  --args
  --auth
  --container-command
  --container-port
  --disk-size
  --env
  --env-secret
  --image
  --name
  --parent-id
  --platform
  --preemptible
  --preset
  --public
  --registry-password
  --registry-secret
  --registry-username
  --shm-size
  --ssh-key
  --subnet-id
  --token
  --token-secret
  --volume
  --working-dir

​
Options

--args (string)

Override container arguments.

--auth (string)

Authentication method, default is none.

A value must be one of:

  • none
  • token

--container-command (string)

Override container entrypoint command.

--container-port (string array)

Container port to expose.

--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_NAME_OR_ID_OR_VERSION_ID format (repeatable, CLI resolves both secret and version).

--image (string)

Container image (format: image:tag).

--name (string)

Application name.

--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).

--preset (string)

Preset for selected platform (e.g. 1gpu-16vcpu-200gb), default is minimum available preset for the platform.

--public (bool)

Whether to assign a public IP to the workload, default is false.

--registry-password (string)

Container registry password.

--registry-secret (string)

Name or ID of Nebius MysteryBox secret with REGISTRY_USERNAME and REGISTRY_PASSWORD payload keys.

--registry-username (string)

Container registry username.

--shm-size (string)

Size of /dev/shm (e.g., 64Mi, 128Mi, 1Gi), default - 16Gi for GPU platforms, 0 for CPU.

--ssh-key (string array)

Configure ssh_authorized_keys for creating VM.

--subnet-id (string)

Network subnet ID.

--token (string)

Token used for endpoint authentication.

--token-secret (string)

Secret name, ID, or version ID with AUTH_TOKEN payload key (CLI resolves both secret and version).

--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_NAME_OR_ID_OR_VERSION_ID. Repeatable.

--working-dir (string)

Working directory (absolute path).

​
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)

Enable debug logs.

--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.

--timeout (duration: 2h30m10s)

Set the timeout for the main request, default is 1m0s.

--no-check-update (bool)

Suppress check for updates.