From 58669f34ef651dee9fb2751c9c2d87d754211f63 Mon Sep 17 00:00:00 2001 From: Jvst Me Date: Mon, 26 Oct 2026 17:11:45 +0100 Subject: [PATCH] [Docs]: `registry_auth` for higher rate limits --- mkdocs/docs/concepts/dev-environments.md | 3 +++ mkdocs/docs/concepts/services.md | 3 +++ mkdocs/docs/concepts/tasks.md | 3 +++ 3 files changed, 9 insertions(+) diff --git a/mkdocs/docs/concepts/dev-environments.md b/mkdocs/docs/concepts/dev-environments.md index 0f99420b44..9a8244b20e 100644 --- a/mkdocs/docs/concepts/dev-environments.md +++ b/mkdocs/docs/concepts/dev-environments.md @@ -298,6 +298,9 @@ ide: vscode +??? info "Registry rate limits" + The `dstack` server queries the Docker registry for details about your custom image, such as its default user and entrypoint. If you are submitting many jobs and hitting the registry’s rate limit, try setting [`registry_auth`](../reference/dstack.yml/dev-environment.md#registry_auth), as many registries offer higher rate limits for authenticated users. + ### Environment variables
diff --git a/mkdocs/docs/concepts/services.md b/mkdocs/docs/concepts/services.md index 0703ce083e..5080f9416a 100644 --- a/mkdocs/docs/concepts/services.md +++ b/mkdocs/docs/concepts/services.md @@ -993,6 +993,9 @@ resources: gpu: H100:1 ``` +??? info "Registry rate limits" + The `dstack` server queries the Docker registry for details about your custom image, such as its default user and entrypoint. If you are submitting many jobs and hitting the registry’s rate limit, try setting [`registry_auth`](../reference/dstack.yml/service.md#registry_auth), as many registries offer higher rate limits for authenticated users. + ### Working directory If `working_dir` is not specified, it defaults to the working directory set in the Docker image. For example, the [default image](#default-image) uses `/dstack/run` as its working directory. diff --git a/mkdocs/docs/concepts/tasks.md b/mkdocs/docs/concepts/tasks.md index 34e68698b9..41dcadeac9 100644 --- a/mkdocs/docs/concepts/tasks.md +++ b/mkdocs/docs/concepts/tasks.md @@ -510,6 +510,9 @@ resources: !!! info "No commands" If `commands` are not specified, `dstack` runs `image`’s entrypoint (or fails if none is set). +??? info "Registry rate limits" + The `dstack` server queries the Docker registry for details about your custom image, such as its default user and entrypoint. If you are submitting many jobs and hitting the registry’s rate limit, try setting [`registry_auth`](../reference/dstack.yml/task.md#registry_auth), as many registries offer higher rate limits for authenticated users. + #### Docker in Docker Set `docker` to `true` to enable the `docker` CLI in your task, e.g., to run or build Docker images, or use Docker Compose.