Skip to main content
POST
Provision DStack app

Body

application/json

Request for provisioning a DStack app with automatic resource matching.

Most fields are optional and will be automatically determined by the resource matching logic in preflight_dstack_app. Only compose_file and name are required.

compose_file
AppComposeV2 · object
required
name
string
required

CVM name (used as hostname): 5-63 chars, must start with letter, can contain letters/numbers/hyphens

instance_type
string | null
vcpu
integer | null
memory
integer | null
disk_size
integer | null
image
string | null
prefer_dev
boolean | null

Prefer dev OS image (True) or non-dev OS image (False). When None, auto-selects based on image name or defaults to dev.

teepod_id
integer | null
region
string | null
listed
boolean
default:true
kms_id
string | null
kms
enum<string> | null
default:phala
Available options:
phala,
ethereum,
base,
legacy
nonce
integer | null

Optional nonce for deterministic app_id generation. When provided, app_id must also be provided. System will verify: app_id == get_create_address(team_wallet, nonce)

app_id
string | null

Optional app_id for manual specification. Required when nonce is provided. Only works with PHALA KMS.

env_keys
string[]
ports
PortMapping · object[] | null
encrypted_env
string | null
user_config
string | null
hugepages
boolean
default:false
pin_numa
boolean
default:false
gpus
GpuConfig · object | null
kms_urls
string[]
gateway_urls
string[]
experimental_vpc_server_app_id
string | null

Response

Provision data with compose_hash for creation