~/.dstack/server/config.yml

May 7, 2026 · View on GitHub

The ~/.dstack/server/config.yml file is used to configure backends and other server-level settings.

Root reference

#SCHEMA# dstack._internal.server.services.config.ServerConfig overrides: show_root_heading: false

`projects[n]` { #projects data-toc-label="projects" }

#SCHEMA# dstack._internal.server.services.config.ProjectConfig overrides: show_root_heading: false

`projects[n].backends` { #backends data-toc-label="backends" }

`projects[n].backends[type=aws]` { #aws data-toc-label="aws" }

#SCHEMA# dstack._internal.core.backends.aws.models.AWSBackendConfigWithCreds overrides: show_root_heading: false type: required: true item_id_prefix: aws-

`projects[n].backends[type=aws].creds` { #aws-creds data-toc-label="creds" }

=== "Access key" #SCHEMA# dstack._internal.core.backends.aws.models.AWSAccessKeyCreds overrides: show_root_heading: false type: required: true

=== "Default" #SCHEMA# dstack._internal.core.backends.aws.models.AWSDefaultCreds overrides: show_root_heading: false type: required: true

`projects[n].backends[type=aws].os_images` { #aws-os_images data-toc-label="os_images" }

#SCHEMA# dstack._internal.core.backends.aws.models.AWSOSImageConfig overrides: show_root_heading: false type: required: true item_id_prefix: aws-os_images-

`projects[n].backends[type=aws].os_images.cpu` { #aws-os_images-cpu data-toc-label="cpu" }

#SCHEMA# dstack._internal.core.backends.aws.models.AWSOSImage overrides: show_root_heading: false type: required: true

`projects[n].backends[type=aws].os_images.nvidia` { #aws-os_images-nvidia data-toc-label="nvidia" }

#SCHEMA# dstack._internal.core.backends.aws.models.AWSOSImage overrides: show_root_heading: false type: required: true

`projects[n].backends[type=azure]` { #azure data-toc-label="azure" }

#SCHEMA# dstack._internal.core.backends.azure.models.AzureBackendConfigWithCreds overrides: show_root_heading: false type: required: true item_id_prefix: azure-

`projects[n].backends[type=azure].creds` { #azure-creds data-toc-label="creds" }

=== "Client" #SCHEMA# dstack._internal.core.backends.azure.models.AzureClientCreds overrides: show_root_heading: false type: required: true

=== "Default" #SCHEMA# dstack._internal.core.backends.azure.models.AzureDefaultCreds overrides: show_root_heading: false type: required: true

`projects[n].backends[type=gcp]` { #gcp data-toc-label="gcp" }

#SCHEMA# dstack._internal.core.backends.gcp.models.GCPBackendConfigWithCreds overrides: show_root_heading: false type: required: true item_id_prefix: gcp-

`projects[n].backends[type=gcp].creds` { #gcp-creds data-toc-label="creds" }

=== "Service account" #SCHEMA# dstack._internal.core.backends.gcp.models.GCPServiceAccountFileCreds overrides: show_root_heading: false type: required: true

??? info "Specifying `data`"
    To specify service account file contents as a string, use `jq`:

    ```shell
    cat my-service-account-file.json | jq -c | jq -R
    ```

=== "Default" #SCHEMA# dstack._internal.core.backends.gcp.models.GCPDefaultCreds overrides: show_root_heading: false type: required: true

`projects[n].backends[type=lambda]` { #lambda data-toc-label="lambda" }

#SCHEMA# dstack._internal.core.backends.lambdalabs.models.LambdaBackendConfigWithCreds overrides: show_root_heading: false type: required: true item_id_prefix: lambda-

`projects[n].backends[type=lambda].creds` { #lambda-creds data-toc-label="creds" }

#SCHEMA# dstack._internal.core.backends.lambdalabs.models.LambdaAPIKeyCreds overrides: show_root_heading: false type: required: true

`projects[n].backends[type=nebius]` { #nebius data-toc-label="nebius" }

#SCHEMA# dstack._internal.core.backends.nebius.models.NebiusBackendFileConfigWithCreds overrides: show_root_heading: false type: required: true item_id_prefix: nebius-

`projects[n].backends[type=nebius].creds` { #nebius-creds data-toc-label="creds" }

#SCHEMA# dstack._internal.core.backends.nebius.models.NebiusServiceAccountFileCreds overrides: show_root_heading: false type: required: true

`projects[n].backends[type=runpod]` { #runpod data-toc-label="runpod" }

#SCHEMA# dstack._internal.core.backends.runpod.models.RunpodBackendConfigWithCreds overrides: show_root_heading: false type: required: true item_id_prefix: runpod-

`projects[n].backends[type=runpod].creds` { #runpod-creds data-toc-label="creds" }

#SCHEMA# dstack._internal.core.backends.runpod.models.RunpodAPIKeyCreds overrides: show_root_heading: false type: required: true

`projects[n].backends[type=vastai]` { #vastai data-toc-label="vastai" }

#SCHEMA# dstack._internal.core.backends.vastai.models.VastAIBackendConfigWithCreds overrides: show_root_heading: false type: required: true item_id_prefix: vastai-

`projects[n].backends[type=vastai].creds` { #vastai-creds data-toc-label="creds" }

#SCHEMA# dstack._internal.core.backends.vastai.models.VastAIAPIKeyCreds overrides: show_root_heading: false type: required: true

`projects[n].backends[type=oci]` { #oci data-toc-label="oci" }

#SCHEMA# dstack._internal.core.backends.oci.models.OCIBackendConfigWithCreds overrides: show_root_heading: false type: required: true item_id_prefix: oci-

`projects[n].backends[type=oci].creds` { #oci-creds data-toc-label="creds" }

=== "Client" #SCHEMA# dstack._internal.core.backends.oci.models.OCIClientCreds overrides: show_root_heading: false type: required: true

=== "Default" #SCHEMA# dstack._internal.core.backends.oci.models.OCIDefaultCreds overrides: show_root_heading: false type: required: true

`projects[n].backends[type=verda]` { #verda data-toc-label="verda" }

#SCHEMA# dstack._internal.core.backends.verda.models.VerdaBackendConfigWithCreds overrides: show_root_heading: false type: required: true item_id_prefix: verda-

`projects[n].backends[type=verda].creds` { #verda-creds data-toc-label="creds" }

#SCHEMA# dstack._internal.core.backends.verda.models.VerdaAPIKeyCreds overrides: show_root_heading: false type: required: true

`projects[n].backends[type=kubernetes]` { #kubernetes data-toc-label="kubernetes" }

#SCHEMA# dstack._internal.core.backends.kubernetes.models.KubernetesBackendConfigWithCreds overrides: show_root_heading: false type: required: true item_id_prefix: kubernetes-

`projects[n].backends[type=kubernetes].kubeconfig` { #kubernetes-kubeconfig data-toc-label="kubeconfig" }

#SCHEMA# dstack._internal.core.backends.kubernetes.models.KubeconfigFileConfig overrides: show_root_heading: false

??? info "Specifying data" To specify kubeconfig contents directly via data, convert it to a string:

```shell
yq -o=json ~/.kube/config | jq -c | jq -R
```