vast-ai · vastzuby · May 29, 2026 · May 29, 2026 · May 29, 2026 · May 29, 2026
diff --git a/docs.json b/docs.json
@@ -159,7 +159,7 @@
             "group": "Teams",
             "icon": "users",
             "pages": [
-              "guides/teams/overview",
+              "guides/teams/teams-overview",
               "guides/teams/managing-teams",
               "guides/teams/teams-roles",
               "guides/teams/legacy-teams"
@@ -865,10 +865,6 @@
       "source": "/cli/commands",
       "destination": "/cli/hello-world"
     },
-    {
-      "source": "/cli/templates",
-      "destination": "/guides/templates/creating-templates"
-    },
     {
       "source": "/sdk/python/templates",
       "destination": "/guides/templates/creating-templates"
@@ -1685,4 +1681,4 @@
       }
     }
   ]
-}
+}
diff --git a/guides/get-started/index.mdx b/guides/get-started/index.mdx
@@ -53,10 +53,6 @@ Vast.ai connects compute providers, from hobbyists to Tier-4 datacenters, with u
   </Card>
 </CardGroup>
 
-## Mission
-
-Vast.ai's mission is to align and democratize AI. Machine learning is progressing towards powerful AI systems with the potential to radically reshape our future. We believe it is imperative that this awesome power be distributed widely; that its benefits accrue to the many rather than the few; that its secrets are unlocked for the good of all humanity. Towards these ends we work to ensure that the compute powering AI is supplied by the people and for the people.
-
 ## Talk to Us
 
 - **Support Chat** → Available 24/7 in the bottom-right corner of our [console](https://cloud.vast.ai).

diff --git a/guides/get-started/quickstart.mdx b/guides/get-started/quickstart.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Sign up and rent your first GPU"
+title: "Rent your first GPU"
 sidebarTitle: "Quickstart"
 slug: ubs2z894DwoYptJmpnZWP
 createdAt: Mon Jan 13 2025 21:20:40 GMT+0000 (Coordinated Universal Time)
@@ -8,33 +8,26 @@ updatedAt: Fri Aug 22 2025 00:35:49 GMT+0000 (Coordinated Universal Time)
 ---
 
 
-
-This Quickstart will guide you through setting up your Vast.ai account and running your first instance in just a few steps.&#x20;
-
 ### 1. Sign Up & Add Credit
 
 - Create an account on [vast.ai.](https://cloud.vast.ai/)
 - Verify your email address.
-- Go to [**Billing**](/guides/reference/billing) → **Add Credit** and top up using [credit card, BitPay, or Crypto.com](/guides/reference/billing#payment-methods).
+- Go to [Billing](/guides/reference/billing) → **Add Credit** and top up using [credit card, BitPay, or Crypto.com](/guides/reference/billing#payment-methods).
 - Learn about [autobilling](/guides/reference/billing#autobilling-credit-card-only) to avoid interruptions.
 
-
-  ![Billing](/images/guides-overview-quick-start.webp)
-- Your balance appears at the top right of the dashboard.
-
-
-  ![](/images/guides-overview-quick-start-2.webp)
+Your current **credit balance** is always shown in the top right of the console header.
 
 <Note>
-  Before you can **rent a machine** or **create a team**, you must [verify your email address](/guides/reference/account-settings#email-verification). After signing up, check your inbox (and spam folder) for the verification email and click the link inside. You can resend the verification email anytime from [**Settings**](/guides/reference/account-settings) → Resend Verification Email. Learn more about [teams](/guides/teams/teams-overview) and [instance management](/guides/instances/manage-instances).
+  Before you can **rent a machine** or **create a team**, you must [verify your email address](/guides/reference/account-settings#email-verification). After signing up, check your inbox (and spam folder) for the verification email and click the link inside. You can resend the verification email anytime from [Settings](/guides/reference/account-settings) → Resend Verification Email. Learn more about [teams](/guides/teams/teams-overview) and [instance management](/guides/instances/manage-instances).
 </Note>
 
 ### &#x32;**. Prepare to Connect**
 
 - **For SSH access**: generate an [SSH key pair](/guides/instances/connect/ssh#generating-ssh-keys) following our [complete SSH guide](/guides/instances/connect/ssh) and upload your **public key** in [Keys page](https://cloud.vast.ai/manage-keys/) or via [account settings](/guides/reference/keys).
 
 
-  ![Keys](/images/guides-overview-quick-start-3.webp)
+  <img src="/images/guides-overview-quick-start-3-light.webp" className="block dark:hidden" alt="Keys" />
+  <img src="/images/guides-overview-quick-start-3-dark.webp" className="hidden dark:block" alt="Keys" />
 - **For Jupyter access**: download and install the provided [TSL certificate](/guides/instances/connect/jupyter#certificate-installation) following our [Jupyter setup guide](/guides/instances/connect/jupyter) (needed for secure browser access).
 
 <Note>
@@ -46,10 +39,10 @@ This Quickstart will guide you through setting up your Vast.ai account and runni
   Installing the certificate once removes the warning permanently.
 </Note>
 
-  ### 3. Pick a [**Template**](/guides/templates/introduction) & Find a Machine
+  ### 3. Pick a [Template](/guides/templates/introduction) & Find a Machine
 
-  - Browse [**Templates**](https://cloud.vast.ai/templates/) for pre-built setups (e.g., [PyTorch](/pytorch), TensorFlow, ComfyUI) or [create custom templates](/guides/templates/creating-templates).
-- Go to [**Search**](https://cloud.vast.ai/create/) and filter by GPU type, count, RAM, CPU, network speed, and price. Learn about [search filters](/guides/instances/choosing/overview#search-filters) and [instance types](/guides/instances/choosing/instance-types).
+  - Browse [Templates](https://cloud.vast.ai/templates/) for pre-built setups (e.g., [PyTorch](/pytorch), TensorFlow, ComfyUI) or [create custom templates](/guides/templates/creating-templates).
+- Go to [Search](https://cloud.vast.ai/create/) and filter by GPU type, count, RAM, CPU, network speed, and price. Learn about [search filters](/guides/instances/choosing/overview#search-filters) and [instance types](/guides/instances/choosing/instance-types).
 - **Disk Space is Permanent.** The disk size you choose when creating an instance cannot be changed later. If you run out of space, you'll need to create a new instance with a larger disk. Learn about [storage types](/guides/instances/storage/types) and [volumes](/guides/instances/storage/volumes). Tip: Allocate a bit more than you think you need to avoid interruptions.
 - Click **Rent** when you find a match. Consider [reserved instances](/guides/instances/choosing/reserved-instances) for 50% savings on long-term projects.
 - Wait for the instance to start-cached images launch quickly, fresh pulls may take 10-60 minutes. Check [instance status](/guides/instances/manage-instances#status) for progress.
@@ -60,7 +53,8 @@ This Quickstart will guide you through setting up your Vast.ai account and runni
 - Use **Stop** to pause GPU billing ([storage still accrues charges](/guides/instances/storage/types#costs)). Learn about the [instance lifecycle](/guides/instances/manage-instances#lifecycle).
 - Use **Delete** when finished to stop *all* charges. See [data movement](/guides/instances/storage/data-movement) if you need to save data first.
 
-![Manage or End Your Instance](/images/guides-overview-quick-start-4.webp)
+<img src="/images/guides-overview-quick-start-4-light.webp" className="block dark:hidden" alt="Manage or End Your Instance" />
+<img src="/images/guides-overview-quick-start-4-dark.webp" className="hidden dark:block" alt="Manage or End Your Instance" />
 
 ## Common Questions
 
@@ -70,7 +64,7 @@ The minimum deposit amount on Vast.ai is $5.
 
 ### What happens when my balance runs out? Can I avoid interruptions?
 
-When your balance reaches zero, your running instances will automatically stop. To avoid this, you can enable [**autobilling**](/guides/reference/billing#autobilling-credit-card-only) on the [Billing page](/guides/reference/billing). Set an auto-charge threshold higher than your average daily spend, so your card is automatically charged when your balance falls below that amount. We also recommend setting a [**low-balance email alert**](/guides/reference/account-settings#notifications) at a slightly lower threshold to notify you if the auto-charge fails for any reason. Learn more about [billing management](/guides/reference/billing) and [cost optimization](/guides/instances/pricing).
+When your balance reaches zero, your running instances will automatically stop. To avoid this, you can enable [autobilling](/guides/reference/billing#autobilling-credit-card-only) on the [Billing page](/guides/reference/billing). Set an auto-charge threshold higher than your average daily spend, so your card is automatically charged when your balance falls below that amount. We also recommend setting a [low-balance email alert](/guides/reference/account-settings#notifications) at a slightly lower threshold to notify you if the auto-charge fails for any reason. Learn more about [billing management](/guides/reference/billing) and [cost optimization](/guides/instances/pricing).
 
 ### How can I customize a template?
 

diff --git a/guides/instances/choosing/find-and-rent.mdx b/guides/instances/choosing/find-and-rent.mdx
@@ -34,7 +34,8 @@ One important concept is the category of machine which is displayed on the offer
 ### Card Details
 
 <Frame caption="Offer Card">
-![Offer Card](https://vast.ai/uploads/offer-card.PNG)
+  <img src="/images/console-instance-guide-5-light.webp" className="block dark:hidden" alt="Offer card showing GPU, host, network, CPU, disk, and motherboard details" />
+  <img src="/images/console-instance-guide-5-dark.webp" className="hidden dark:block" alt="Offer card showing GPU, host, network, CPU, disk, and motherboard details" />
 </Frame>
 
 All stats shown are the portion of the total machine rented.
@@ -66,7 +67,8 @@ The storage slider is both a search filter and a parameter input which determine
 When the instance is created, the disk size is set and cannot be modified. It is important to estimate how much disk you will need and then to move the slider to the desired disk size. The default disk size for an instance is 10GB. Use the slider to allocate more or less, taking into consideration that providers charge for disk allocation even when the instance is stopped.
 
 <Frame caption="Disk Space">
-![Diskspace](https://vast.ai/uploads/Search/DiskSpace.png)
+  <img src="/images/search-disk-space-light.webp" className="block dark:hidden" alt="Container size slider on the search page" />
+  <img src="/images/search-disk-space-dark.webp" className="hidden dark:block" alt="Container size slider on the search page" />
 </Frame>
 
 ## Instance Configuration
@@ -76,8 +78,9 @@ Vast.ai provides out Linux docker instances. One key step during setup is specif
 The instance configuration menu is accessible in the upper left of the create instance interface. The current template is always displayed in the upper left.
 Click on the "Change Template" button to bring up the template config menu that allows selecting and editing templates. For a quick overview, see [Choosing a Template](/guides/instances/choosing/templates). For detailed template creation and Docker configuration, see the main [Templates documentation](/guides/templates/introduction)
 
-<Frame caption="Edit">
-![Edit](https://vast.ai/uploads/Search/Edit.png)
+<Frame caption="Template selector with Change Template button">
+  <img src="/images/change-template-light.webp" className="block dark:hidden" alt="Template selector with Change Template button" />
+  <img src="/images/change-template-dark.webp" className="hidden dark:block" alt="Template selector with Change Template button" />
 </Frame>
 
 ## Common Questions

diff --git a/guides/instances/choosing/overview.mdx b/guides/instances/choosing/overview.mdx
@@ -74,4 +74,4 @@ Set up search alerts or try different regions. Availability changes frequently a
 
 ## Next Steps
 
-Ready to get started? Begin with **[Instance Types →](/guides/instances/choosing/instance-types)** to understand your options.
+Ready to get started? Begin with [Instance Types →](/guides/instances/choosing/instance-types) to understand your options.
diff --git a/guides/instances/choosing/reserved-instances.mdx b/guides/instances/choosing/reserved-instances.mdx
@@ -30,7 +30,7 @@ You can **convert an on-demand instance into a reserved instance** with a lower
 
     **Step 2, Convert to a Reserved Instance**
 
-    1. Go to the [**Instances**](https://cloud.vast.ai/instances/) page.
+    1. Go to the [Instances](https://cloud.vast.ai/instances/) page.
     2. On your instance card, find the **green** **discount badge**.
 
        <Frame caption="Save badge">
@@ -115,13 +115,15 @@ You can check the reserved price before committing:
 2. Switch the **On-demand** filter to the **Reserved** filter.
 
    <Frame caption="Reserved Filter">
-     ![Reserved Filter](/images/instances-reserved-5.webp)
+     <img src="/images/instances-reserved-5-light.webp" className="block dark:hidden" alt="Reserved Filter" />
+     <img src="/images/instances-reserved-5-dark.webp" className="hidden dark:block" alt="Reserved Filter" />
    </Frame>
 3. Set the **duration filter** (e.g., 1 month), if needed.
 4. Hover over the **Rent** button, you'll see a breakdown, including a **Reserved cost** section.
 
    <Frame caption="Price Breakdown">
-     ![Price](/images/instances-reserved-6.webp)
+     <img src="/images/instances-reserved-6-light.webp" className="block dark:hidden" alt="Price Breakdown" />
+     <img src="/images/instances-reserved-6-dark.webp" className="hidden dark:block" alt="Price Breakdown" />
    </Frame>
 5. If you like the price, click **Rent** and follow the steps to convert it to a reserved instance.
 
@@ -139,7 +141,9 @@ Yes, you can extend it anytime via the same discount badge in the Instances page
 
 You'll receive a partial refund of your unused pre-paid balance, minus the total discount received so far. The refund amount will be displayed in the delete instance modal and will also appear on the Billing page after you delete the instance.
 
-![image.png](/images/image.png)
+<Frame>
+  ![Destroy reserved instance refund modal](/images/console-destroy-instance-refund.webp)
+</Frame>
 
 ### What happens if I stop a reserved instance?
 

diff --git a/guides/instances/connect/instance-portal.mdx b/guides/instances/connect/instance-portal.mdx
@@ -17,15 +17,7 @@ The Instance Portal is the first application you will see after clicking the 'Op
 
 ## Loading Process
 
-Upon opening the Instance Portal you will see a loading indicator for a short time.&#x20;
-
-
-
-<Frame caption="Loading Indicator">
-![Loading Indicator](/images/console-templates-instance-portal-2.webp)
-</Frame>
-
-During this loading phase, a secure Cloudflare tunnel will be created for each of your instance's open ports and the browser will test whether these tunnel links are accessible.
+Upon opening the Instance Portal you will see a loading indicator for a short time. During this loading phase, a secure Cloudflare tunnel will be created for each of your instance's open ports and the browser will test whether these tunnel links are accessible.
 
 The secure tunnel link will be formatted like this:
 
@@ -40,7 +32,8 @@ If you would like the default application URLs to be **https\://** rather than *
 
 
 <Frame caption="Enable HTTPS Variable">
-![Enable HTTPS Variable](/images/console-templates-instance-portal-3.webp)
+  <img src="/images/console-templates-instance-portal-3-light.webp" className="block dark:hidden" alt="Enable HTTPS Variable" />
+  <img src="/images/console-templates-instance-portal-3-dark.webp" className="hidden dark:block" alt="Enable HTTPS Variable" />
 </Frame>
 
 
@@ -54,7 +47,8 @@ The instance Portal has a simple interface to help you access other web applicat
 
 
 <Frame caption="Landing Page">
-![Landing Page](/images/console-templates-instance-portal-4.webp)
+  <img src="/images/console-templates-instance-portal-4-light.webp" className="block dark:hidden" alt="Landing Page" />
+  <img src="/images/console-templates-instance-portal-4-dark.webp" className="hidden dark:block" alt="Landing Page" />
 </Frame>
 
 The large blue 'Launch Application' buttons will open your running applications in a new browser tab. &#x20;
@@ -72,7 +66,8 @@ Use this page to manage existing secure tunnels and add new tunnels to get acces
 
 
 <Frame caption="Tunnels Page">
-![Tunnels Page](/images/console-templates-instance-portal-5.webp)
+  <img src="/images/console-templates-instance-portal-5-light.webp" className="block dark:hidden" alt="Tunnels Page" />
+  <img src="/images/console-templates-instance-portal-5-dark.webp" className="hidden dark:block" alt="Tunnels Page" />
 </Frame>
 
 Use this interface to create links to applications you have started after configuring your instance. For example:
@@ -96,7 +91,8 @@ Use the 'Copy Logs' button to copy the currently displayed logging output to you
 
 
 <Frame caption="Instance Portal logs interface">
-![Logs Page](/images/console-templates-instance-portal-6.webp)
+  <img src="/images/console-templates-instance-portal-6-light.webp" className="block dark:hidden" alt="Logs Page" />
+  <img src="/images/console-templates-instance-portal-6-dark.webp" className="hidden dark:block" alt="Logs Page" />
 </Frame>
 
 ## Tools & Help Page
@@ -106,7 +102,8 @@ This page links to useful pages in the Vast.ai documentation to help you get the
 
 
 <Frame caption="Instance Portal tools and help page">
-![Instance Portal tools and help page](/images/console-templates-instance-portal-7.webp)
+  <img src="/images/console-templates-instance-portal-7-light.webp" className="block dark:hidden" alt="Instance Portal tools and help page" />
+  <img src="/images/console-templates-instance-portal-7-dark.webp" className="hidden dark:block" alt="Instance Portal tools and help page" />
 </Frame>
 
 ## Configuration
Original file line number	Diff line number	Diff line change
Expand Up		@@ -74,4 +74,4 @@ Set up search alerts or try different regions. Availability changes frequently a

		## Next Steps

		Ready to get started? Begin with [Instance Types →](/guides/instances/choosing/instance-types) to understand your options.
		Ready to get started? Begin with [Instance Types →](/guides/instances/choosing/instance-types) to understand your options.