Deploying to gh-pages from @ dstackai/dstack@2410c47 🚀

Author: peterschmidt85

assets/images/social/examples.png

@@ -1105,10 +1105,27 @@ projects:
 </div>
 
 ??? info "Community Cloud"
-    By default, `dstack` considers instance offers from both the Secure Cloud and the
-    [Community Cloud](https://docs.runpod.io/references/faq/#secure-cloud-vs-community-cloud).
+    By default, `dstack` considers instance offers only from the Secure Cloud.
+    To also include the
+    [Community Cloud](https://docs.runpod.io/references/faq/#secure-cloud-vs-community-cloud),
+    set `community_cloud: true` in the backend settings.
 
-    You can tell them apart by their regions.
+    <div editor-title="~/.dstack/server/config.yml">
+
+    ```yaml
+    projects:
+      - name: main
+        backends:
+          - type: runpod
+            creds:
+              type: api_key
+              api_key: US9XTPDIV8AR42MMINY8TCKRB8S4E7LNRQ6CAUQ9
+            community_cloud: true
+    ```
+
+    </div>
+
+    You can tell Secure Cloud and Community Cloud apart by their regions.
     Secure Cloud regions contain datacenter IDs such as `CA-MTL-3`.
     Community Cloud regions contain country codes such as `CA`.
 
@@ -1124,23 +1141,6 @@ projects:
 
     </div>
 
-    If you don't want to use the Community Cloud, set `community_cloud: false` in the backend settings.
-
-    <div editor-title="~/.dstack/server/config.yml">
-
-    ```yaml
-    projects:
-      - name: main
-        backends:
-          - type: runpod
-            creds:
-              type: api_key
-              api_key: US9XTPDIV8AR42MMINY8TCKRB8S4E7LNRQ6CAUQ9
-            community_cloud: false
-    ```
-
-    </div>
-
 ### Vast.ai
 
 Log into your [Vast.ai](https://cloud.vast.ai/) account, click Account in the sidebar, and copy your

assets/images/social/index.png

@@ -5502,20 +5502,10 @@ <h3 id="runpod">RunPod<a class="headerlink" href="#runpod" title="Permanent link
 
 <details class="info">
 <summary>Community Cloud</summary>
-<p>By default, <code>dstack</code> considers instance offers from both the Secure Cloud and the
-<a href="https://docs.runpod.io/references/faq/#secure-cloud-vs-community-cloud">Community Cloud</a>.</p>
-<p>You can tell them apart by their regions.
-Secure Cloud regions contain datacenter IDs such as <code>CA-MTL-3</code>.
-Community Cloud regions contain country codes such as <code>CA</code>.</p>
-<div class="termy">
-<div class="highlight"><pre><span></span><code>$<span class="w"> </span>dstack<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>.dstack.yml<span class="w"> </span>-b<span class="w"> </span>runpod
-
-<span class="w"> </span><span class="c1">#  BACKEND  REGION    INSTANCE               SPOT  PRICE</span>
-<span class="w"> </span><span class="m">1</span><span class="w">  </span>runpod<span class="w">   </span>CA<span class="w">        </span>NVIDIA<span class="w"> </span>A100<span class="w"> </span>80GB<span class="w"> </span>PCIe<span class="w">  </span>yes<span class="w">   </span><span class="nv">$0</span>.6
-<span class="w"> </span><span class="m">2</span><span class="w">  </span>runpod<span class="w">   </span>CA-MTL-3<span class="w">  </span>NVIDIA<span class="w"> </span>A100<span class="w"> </span>80GB<span class="w"> </span>PCIe<span class="w">  </span>yes<span class="w">   </span><span class="nv">$0</span>.82
-</code></pre></div>
-</div>
-<p>If you don't want to use the Community Cloud, set <code>community_cloud: false</code> in the backend settings.</p>
+<p>By default, <code>dstack</code> considers instance offers only from the Secure Cloud.
+To also include the
+<a href="https://docs.runpod.io/references/faq/#secure-cloud-vs-community-cloud">Community Cloud</a>,
+set <code>community_cloud: true</code> in the backend settings.</p>
 <div editor-title="~/.dstack/server/config.yml">
 <div class="highlight"><pre><span></span><code><span class="nt">projects</span><span class="p">:</span>
 <span class="w">  </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">main</span>
@@ -5524,7 +5514,18 @@ <h3 id="runpod">RunPod<a class="headerlink" href="#runpod" title="Permanent link
 <span class="w">        </span><span class="nt">creds</span><span class="p">:</span>
 <span class="w">          </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">api_key</span>
 <span class="w">          </span><span class="nt">api_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">US9XTPDIV8AR42MMINY8TCKRB8S4E7LNRQ6CAUQ9</span>
-<span class="w">        </span><span class="nt">community_cloud</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">false</span>
+<span class="w">        </span><span class="nt">community_cloud</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
+</code></pre></div>
+</div>
+<p>You can tell Secure Cloud and Community Cloud apart by their regions.
+Secure Cloud regions contain datacenter IDs such as <code>CA-MTL-3</code>.
+Community Cloud regions contain country codes such as <code>CA</code>.</p>
+<div class="termy">
+<div class="highlight"><pre><span></span><code>$<span class="w"> </span>dstack<span class="w"> </span>apply<span class="w"> </span>-f<span class="w"> </span>.dstack.yml<span class="w"> </span>-b<span class="w"> </span>runpod
+
+<span class="w"> </span><span class="c1">#  BACKEND  REGION    INSTANCE               SPOT  PRICE</span>
+<span class="w"> </span><span class="m">1</span><span class="w">  </span>runpod<span class="w">   </span>CA<span class="w">        </span>NVIDIA<span class="w"> </span>A100<span class="w"> </span>80GB<span class="w"> </span>PCIe<span class="w">  </span>yes<span class="w">   </span><span class="nv">$0</span>.6
+<span class="w"> </span><span class="m">2</span><span class="w">  </span>runpod<span class="w">   </span>CA-MTL-3<span class="w">  </span>NVIDIA<span class="w"> </span>A100<span class="w"> </span>80GB<span class="w"> </span>PCIe<span class="w">  </span>yes<span class="w">   </span><span class="nv">$0</span>.82
 </code></pre></div>
 </div>
 </details>

docs/concepts/backends.md

@@ -290,7 +290,7 @@ $ dstack ps --verbose
 
 </div>
 
-??? info "Probe statuses"
+??? info "Status"
     The following symbols are used for probe statuses:
 
     - `×` &mdash; the last probe execution failed.
@@ -328,6 +328,11 @@ Probes are executed for each service replica while the replica is `running`. A p
 
     </div>
 
+??? info "Model"
+    If you set the [`model`](#model) property but don't explicitly configure `probes`, 
+    `dstack` automatically configures a default probe that tests the model using the `/v1/chat/completions` API.
+    To disable probes entirely when `model` is set, explicitly set `probes` to an empty list.
+
 See the [reference](../reference/dstack.yml/service.md#probes) for more probe configuration options.
 
 ### Path prefix { #path-prefix }
@@ -425,6 +430,9 @@ Limits apply to the whole service (all replicas) and per client (by IP). Clients
 If the service runs a model with an OpenAI-compatible interface, you can set the [`model`](#model) property to make the model accessible through `dstack`'s chat UI on the `Models` page. 
 In this case, `dstack` will use the service's `/v1/chat/completions` service.
 
+When `model` is set, `dstack` automatically configures [`probes`](#probes) to verify model health.
+To customize or disable this, set `probes` explicitly.
+
 ### Resources
 
 If you specify memory size, you can either specify an explicit size (e.g. `24GB`) or a 

docs/concepts/backends/index.html

@@ -4912,7 +4912,7 @@ <h3 id="probes">Probes<a class="headerlink" href="#probes" title="Permanent link
 </div>
 
 <details class="info">
-<summary>Probe statuses</summary>
+<summary>Status</summary>
 <p>The following symbols are used for probe statuses:</p>
 <ul>
 <li><code>×</code> &mdash; the last probe execution failed.</li>
@@ -4946,6 +4946,12 @@ <h3 id="probes">Probes<a class="headerlink" href="#probes" title="Permanent link
 </code></pre></div>
 </div>
 </details>
+<details class="info">
+<summary>Model</summary>
+<p>If you set the <a href="#model"><code>model</code></a> property but don't explicitly configure <code>probes</code>, 
+<code>dstack</code> automatically configures a default probe that tests the model using the <code>/v1/chat/completions</code> API.
+To disable probes entirely when <code>model</code> is set, explicitly set <code>probes</code> to an empty list.</p>
+</details>
 <p>See the <a href="../../reference/dstack.yml/service/#probes">reference</a> for more probe configuration options.</p>
 <h3 id="path-prefix">Path prefix<a class="headerlink" href="#path-prefix" title="Permanent link">&para;</a></h3>
 <p>If your <code>dstack</code> project doesn't have a <a href="../gateways/">gateway</a>, services are hosted with the
@@ -5027,6 +5033,8 @@ <h3 id="rate-limits">Rate limits<a class="headerlink" href="#rate-limits" title=
 <h3 id="model">Model<a class="headerlink" href="#model" title="Permanent link">&para;</a></h3>
 <p>If the service runs a model with an OpenAI-compatible interface, you can set the <a href="#model"><code>model</code></a> property to make the model accessible through <code>dstack</code>'s chat UI on the <code>Models</code> page. 
 In this case, <code>dstack</code> will use the service's <code>/v1/chat/completions</code> service.</p>
+<p>When <code>model</code> is set, <code>dstack</code> automatically configures <a href="#probes"><code>probes</code></a> to verify model health.
+To customize or disable this, set <code>probes</code> explicitly.</p>
 <h3 id="resources">Resources<a class="headerlink" href="#resources" title="Permanent link">&para;</a></h3>
 <p>If you specify memory size, you can either specify an explicit size (e.g. <code>24GB</code>) or a 
 range (e.g. <code>24GB..</code>, or <code>24GB..80GB</code>, or <code>..80GB</code>).</p>

docs/concepts/services.md

@@ -109,30 +109,6 @@ Once the server is up, you can access it via the `dstack` CLI.
     (or `Use Git and optional Unix tools from the Command Prompt`), and 
     `Use bundled OpenSSH`.
 
-### Configure the default project
-
-To point the CLI to the `dstack` server, configure it
-with the server address, user token, and project name:
-
-<div class="termy">
-
-```shell
-$ dstack project add \
-    --name main \
-    --url http://127.0.0.1:3000 \
-    --token bbae0f28-d3dd-4820-bf61-8f4bb40815da
-    
-Configuration is updated at ~/.dstack/config.yml
-```
-
-</div>
-
-This configuration is stored in `~/.dstack/config.yml`.
-
-<!-- ### Check offers -->
-
-<!-- To verify that both the server and CLI are properly configured, use the [`dstack offer`](reference/cli/dstack/offer.md#list-gpu-offers) command to list available GPU offers. If you don't see valid offers, ensure you've set up [backends](concepts/backends.md). -->
-
 ??? info "Shell autocompletion"
 
     `dstack` supports shell autocompletion for `bash` and `zsh`.
@@ -199,9 +175,41 @@ This configuration is stored in `~/.dstack/config.yml`.
         > If you get an error similar to `2: command not found: compdef`, then add the following line to the beginning of your `~/.zshrc` file:
         > `autoload -Uz compinit && compinit`.
 
+### Configure the default project
+
+To point the CLI to the `dstack` server, configure it
+with the server address, user token, and project name:
+
+<div class="termy">
+
+```shell
+$ dstack project add \
+    --name main \
+    --url http://127.0.0.1:3000 \
+    --token bbae0f28-d3dd-4820-bf61-8f4bb40815da
+    
+Configuration is updated at ~/.dstack/config.yml
+```
+
+</div>
+
+This configuration is stored in `~/.dstack/config.yml`.
+
+### Install agent skills
+
+Install [skills](https://skills.sh/dstackai/dstack/dstack) to help AI agents use the `dstack` CLI and edit configuration files.
+
+<div class="termy">
+
+```shell
+$ npx skills add dstackai/dstack
+```
+
+</div>
+
+Agent skills are experimental. Share your feedback via [GitHub issues](https://github.com/dstackai/dstack/issues).
+
 !!! info "What's next?"
     1. See [Backends](concepts/backends.md)
     2. Follow [Quickstart](quickstart.md)
     3. Check the [server deployment](guides/server-deployment.md) guide
-    4. Browse [examples](../examples.md)
-    5. Join the community via [Discord](https://discord.gg/u8SmfwPpMd)

docs/concepts/services/index.html

@@ -732,6 +732,19 @@
     </span>
   </a>
 
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#install-agent-skills" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Install agent skills
+        </span>
+      
+    </span>
+  </a>
+  
 </li>
 
       </ul>
@@ -4083,6 +4096,19 @@
     </span>
   </a>
 
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#install-agent-skills" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <span class="md-typeset">
+          Install agent skills
+        </span>
+      
+    </span>
+  </a>
+  
 </li>
 
       </ul>
@@ -4263,26 +4289,6 @@ <h2 id="set-up-the-cli">Set up the CLI<a class="headerlink" href="#set-up-the-cl
 (or <code>Use Git and optional Unix tools from the Command Prompt</code>), and 
 <code>Use bundled OpenSSH</code>.</p>
 </details>
-<h3 id="configure-the-default-project">Configure the default project<a class="headerlink" href="#configure-the-default-project" title="Permanent link">&para;</a></h3>
-<p>To point the CLI to the <code>dstack</code> server, configure it
-with the server address, user token, and project name:</p>
-<div class="termy">
-
-<div class="highlight"><pre><span></span><code>$<span class="w"> </span>dstack<span class="w"> </span>project<span class="w"> </span>add<span class="w"> </span><span class="se">\</span>
-<span class="w">    </span>--name<span class="w"> </span>main<span class="w"> </span><span class="se">\</span>
-<span class="w">    </span>--url<span class="w"> </span>http://127.0.0.1:3000<span class="w"> </span><span class="se">\</span>
-<span class="w">    </span>--token<span class="w"> </span>bbae0f28-d3dd-4820-bf61-8f4bb40815da
-
-Configuration<span class="w"> </span>is<span class="w"> </span>updated<span class="w"> </span>at<span class="w"> </span>~/.dstack/config.yml
-</code></pre></div>
-
-</div>
-
-<p>This configuration is stored in <code>~/.dstack/config.yml</code>.</p>
-<!-- ### Check offers -->
-
-<!-- To verify that both the server and CLI are properly configured, use the [`dstack offer`](reference/cli/dstack/offer.md#list-gpu-offers) command to list available GPU offers. If you don't see valid offers, ensure you've set up [backends](concepts/backends.md). -->
-
 <details class="info">
 <summary>Shell autocompletion</summary>
 <p><code>dstack</code> supports shell autocompletion for <code>bash</code> and <code>zsh</code>.</p>
@@ -4329,14 +4335,38 @@ <h3 id="configure-the-default-project">Configure the default project<a class="he
 </div>
 </div>
 </details>
+<h3 id="configure-the-default-project">Configure the default project<a class="headerlink" href="#configure-the-default-project" title="Permanent link">&para;</a></h3>
+<p>To point the CLI to the <code>dstack</code> server, configure it
+with the server address, user token, and project name:</p>
+<div class="termy">
+
+<div class="highlight"><pre><span></span><code>$<span class="w"> </span>dstack<span class="w"> </span>project<span class="w"> </span>add<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--name<span class="w"> </span>main<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--url<span class="w"> </span>http://127.0.0.1:3000<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--token<span class="w"> </span>bbae0f28-d3dd-4820-bf61-8f4bb40815da
+
+Configuration<span class="w"> </span>is<span class="w"> </span>updated<span class="w"> </span>at<span class="w"> </span>~/.dstack/config.yml
+</code></pre></div>
+
+</div>
+
+<p>This configuration is stored in <code>~/.dstack/config.yml</code>.</p>
+<h3 id="install-agent-skills">Install agent skills<a class="headerlink" href="#install-agent-skills" title="Permanent link">&para;</a></h3>
+<p>Install <a href="https://skills.sh/dstackai/dstack/dstack">skills</a> to help AI agents use the <code>dstack</code> CLI and edit configuration files.</p>
+<div class="termy">
+
+<div class="highlight"><pre><span></span><code>$<span class="w"> </span>npx<span class="w"> </span>skills<span class="w"> </span>add<span class="w"> </span>dstackai/dstack
+</code></pre></div>
+
+</div>
+
+<p>Agent skills are experimental. Share your feedback via <a href="https://github.com/dstackai/dstack/issues">GitHub issues</a>.</p>
 <div class="admonition info">
 <p class="admonition-title">What's next?</p>
 <ol>
 <li>See <a href="../concepts/backends/">Backends</a></li>
 <li>Follow <a href="../quickstart/">Quickstart</a></li>
 <li>Check the <a href="../guides/server-deployment/">server deployment</a> guide</li>
-<li>Browse <a href="../../examples/">examples</a></li>
-<li>Join the community via <a href="https://discord.gg/u8SmfwPpMd">Discord</a></li>
 </ol>
 </div>
 

docs/installation.md

@@ -5741,7 +5741,7 @@ <h6 class="reference-item" id="https"><code>https</code> - (Optional) Enable HTT
 <h6 class="reference-item" id="auth"><code>auth</code> - (Optional) Enable the authorization. Defaults to <code>True</code>.<a class="headerlink" href="#auth" title="Permanent link">&para;</a></h6>
 <h6 class="reference-item" id="_scaling"><a href="#dstack.api.Scaling"><code>scaling</code></a> - (Optional) The auto-scaling rules. Required if <code>replicas</code> is set to a range.<a class="headerlink" href="#_scaling" title="Permanent link">&para;</a></h6>
 <h6 class="reference-item" id="_rate_limits"><a href="#rate_limits"><code>rate_limits</code></a> - (Optional) Rate limiting rules.<a class="headerlink" href="#_rate_limits" title="Permanent link">&para;</a></h6>
-<h6 class="reference-item" id="_probes"><a href="#probes"><code>probes</code></a> - (Optional) List of probes used to determine job health.<a class="headerlink" href="#_probes" title="Permanent link">&para;</a></h6>
+<h6 class="reference-item" id="probes"><code>probes</code> - (Optional) The list of probes to determine service health. If <code>model</code> is set, defaults to a <code>/v1/chat/completions</code> probe. Set explicitly to override.<a class="headerlink" href="#probes" title="Permanent link">&para;</a></h6>
 <h6 class="reference-item" id="replicas"><code>replicas</code> - (Optional) The number of replicas or a list of replica groups. Can be an integer (e.g., <code>2</code>), a range (e.g., <code>0..4</code>), or a list of replica groups. Each replica group defines replicas with shared configuration (commands, resources, scaling). When <code>replicas</code> is a list of replica groups, top-level <code>scaling</code>, <code>commands</code>, and <code>resources</code> are not allowed and must be specified in each replica group instead. .<a class="headerlink" href="#replicas" title="Permanent link">&para;</a></h6>
 <h6 class="reference-item" id="commands"><code>commands</code> - (Optional) The shell commands to run.<a class="headerlink" href="#commands" title="Permanent link">&para;</a></h6>
 <h6 class="reference-item" id="name"><code>name</code> - (Optional) The run name. If not specified, a random name is generated.<a class="headerlink" href="#name" title="Permanent link">&para;</a></h6>