Deploying to gh-pages from @ dstackai/dstack@43ffb4d 🚀

Author: peterschmidt85

static/quotes/alvarobartt.jpg assets/images/quotes/alvarobartt.jpgstatic/quotes/alvarobartt.jpg renamed to assets/images/quotes/alvarobartt.jpg

@@ -5,7 +5,10 @@ description: Deploying the dstack server
 
 The `dstack` server can run on your laptop or any environment with access to the cloud and on-prem clusters you plan to use.
 
-The minimum hardware requirements for running the server are 1 CPU and 1GB of RAM.
+??? info "Hardware requirements"
+    The minimum hardware requirements for running the server are 1 CPU and 1GB of RAM. The recommended RAM is
+    "8MB × number of active instances". For example, a server with 1000 active instances should have 8GB of RAM.
+    You can set the `DSTACK_SERVER_SSH_POOL_DISABLED` env var to minimize RAM usage at the expense of slower processing.
 
 === "pip"
     > The server can be set up via `pip` on Linux, macOS, and Windows (via WSL 2). It requires Git and OpenSSH.
@@ -43,7 +46,7 @@ The minimum hardware requirements for running the server are 1 CPU and 1GB of RA
     </div>
 
 === "Docker"
-     > To deploy the server most reliably, it's recommended to use `dstackai/dstack` Docker image.
+     > For production deployments, it's recommended to use `dstackai/dstack` Docker image.
 
     <div class="termy">
 

static/quotes/chansung.jpg assets/images/quotes/chansung.jpgstatic/quotes/chansung.jpg renamed to assets/images/quotes/chansung.jpg

@@ -5375,7 +5375,12 @@
   <h1>Server deployment</h1>
 
 <p>The <code>dstack</code> server can run on your laptop or any environment with access to the cloud and on-prem clusters you plan to use.</p>
-<p>The minimum hardware requirements for running the server are 1 CPU and 1GB of RAM.</p>
+<details class="info">
+<summary>Hardware requirements</summary>
+<p>The minimum hardware requirements for running the server are 1 CPU and 1GB of RAM. The recommended RAM is
+"8MB × number of active instances". For example, a server with 1000 active instances should have 8GB of RAM.
+You can set the <code>DSTACK_SERVER_SSH_POOL_DISABLED</code> env var to minimize RAM usage at the expense of slower processing.</p>
+</details>
 <div class="tabbed-set tabbed-alternate" data-tabs="1:3"><input checked="checked" id="pip" name="__tabbed_1" type="radio" /><input id="uv" name="__tabbed_1" type="radio" /><input id="docker" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="pip">pip</label><label for="uv">uv</label><label for="docker">Docker</label></div>
 <div class="tabbed-content">
 <div class="tabbed-block">
@@ -5410,7 +5415,7 @@ <h1>Server deployment</h1>
 </div>
 <div class="tabbed-block">
 <blockquote>
-<p>To deploy the server most reliably, it's recommended to use <code>dstackai/dstack</code> Docker image.</p>
+<p>For production deployments, it's recommended to use <code>dstackai/dstack</code> Docker image.</p>
 </blockquote>
 <div class="termy">
 <div class="highlight"><pre><span></span><code>$<span class="w"> </span>docker<span class="w"> </span>run<span class="w"> </span>-p<span class="w"> </span><span class="m">3000</span>:3000<span class="w"> </span><span class="se">\</span>

static/quotes/eckart.png assets/images/quotes/eckart.pngstatic/quotes/eckart.png renamed to assets/images/quotes/eckart.png

@@ -146,6 +146,8 @@ For more details on the options below, refer to the [server deployment](../guide
 - `DSTACK_SERVER_SSHPROXY_ENFORCED`{ #DSTACK_SERVER_SSHPROXY_ENFORCED } – When set to any value, restricts all SSH connections to go through the SSH proxy.
 - `DSTACK_SERVER_JOB_NETWORK_MODE`{ #DSTACK_SERVER_JOB_NETWORK_MODE } – Controls the network mode assigned to jobs. Accepts an integer value: `1` forces bridge networking for single-node jobs while distributed tasks still use host networking; `2` uses host networking whenever the job occupies a full instance (default); `3` forces bridge networking for all jobs including distributed tasks.
 - `DSTACK_SERVER_SSH_CONNECT_TIMEOUT`{ #DSTACK_SERVER_SSH_CONNECT_TIMEOUT } – The SSH `ConnectTimeout` for server-instance connections, in seconds. Defaults to `3`. Increase if there are high-latency links between the server and instances.
+- `DSTACK_SERVER_SSH_POOL_DISABLED`{ #DSTACK_SERVER_SSH_POOL_DISABLED } – Disables the reuse of server SSH connections to instances. If set, significantly decreases server RAM usage, but
+slows down processing and may cause CPU spikes due to frequent SSH-connection establishment.
 
 ??? info "Internal environment variables"
      The following environment variables are intended for development purposes:

static/quotes/jon.jpeg assets/images/quotes/jon.jpegstatic/quotes/jon.jpeg renamed to assets/images/quotes/jon.jpeg

@@ -4998,6 +4998,8 @@ <h2 id="server">Server<a class="headerlink" href="#server" title="Permanent link
 <li><code id="DSTACK_SERVER_SSHPROXY_ENFORCED">DSTACK_SERVER_SSHPROXY_ENFORCED</code> – When set to any value, restricts all SSH connections to go through the SSH proxy.</li>
 <li><code id="DSTACK_SERVER_JOB_NETWORK_MODE">DSTACK_SERVER_JOB_NETWORK_MODE</code> – Controls the network mode assigned to jobs. Accepts an integer value: <code>1</code> forces bridge networking for single-node jobs while distributed tasks still use host networking; <code>2</code> uses host networking whenever the job occupies a full instance (default); <code>3</code> forces bridge networking for all jobs including distributed tasks.</li>
 <li><code id="DSTACK_SERVER_SSH_CONNECT_TIMEOUT">DSTACK_SERVER_SSH_CONNECT_TIMEOUT</code> – The SSH <code>ConnectTimeout</code> for server-instance connections, in seconds. Defaults to <code>3</code>. Increase if there are high-latency links between the server and instances.</li>
+<li><code id="DSTACK_SERVER_SSH_POOL_DISABLED">DSTACK_SERVER_SSH_POOL_DISABLED</code> – Disables the reuse of server SSH connections to instances. If set, significantly decreases server RAM usage, but
+slows down processing and may cause CPU spikes due to frequent SSH-connection establishment.</li>
 </ul>
 <details class="info">
 <summary>Internal environment variables</summary>