From 2f8e2a237bfea323a4954cbad299c8da48fb5522 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Mon, 28 Sep 2026 13:50:58 -0400 Subject: [PATCH 01/12] Create overview.mdx --- hybrid-cloud/overview.mdx | 68 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 hybrid-cloud/overview.mdx diff --git a/hybrid-cloud/overview.mdx b/hybrid-cloud/overview.mdx new file mode 100644 index 000000000..752cec55d --- /dev/null +++ b/hybrid-cloud/overview.mdx @@ -0,0 +1,68 @@ +--- +title: "Runpod Hybrid Cloud" +sidebarTitle: "Overview" +description: "Run AI workloads on the GPUs you own and on Runpod cloud from one console. Your hardware runs first, and Runpod cloud handles overflow." +--- + +Runpod Hybrid Cloud lets you bring hardware you already own under the same console, CLI, and APIs your team uses on Runpod. Your compute runs first, and Runpod cloud handles overflow when you need it. + +## Requirements + +Runpod Hybrid Cloud is available to organizations only. The Runpod team must enable External Compute for your org account before the feature appears in your console. [Contact us](https://www.runpod.io/everywhere) to get set up. + +## How it works + + + + In the console, go to **Resources → External compute** and click **Add compute**. Select your machine type (on-prem server, AWS EC2 instance, or any cloud VM), give it a name, and click **Next**. + + + Copy the install command that appears and paste it into an SSH session on your machine. This installs the Runpod host agent, a small program that connects your machine to Runpod over an outbound-only encrypted connection. No inbound ports are opened. Set your public and private IPs, open the required firewall ports, then reboot. For full instructions, see [Set up external compute](/hybrid-cloud/setup). + + + Runpod runs automated hardware checks in the background. You don't need to do anything. When verification is complete, the machine's status changes to **Online** and its GPU type appears in the console. + + + Your team deploys Pods exactly as they would for any Runpod machine. An **External Compute** section appears in the GPU picker showing your available hardware. The deploy experience is identical to standard Runpod Pods. See [Deploy Pods on your external compute](/hybrid-cloud/deploy). External compute usage is tracked in the console so you can see how many GPUs are in use at any time. + + + +## What you get + +**One control plane across owned and cloud compute** + +Manage the hardware you own and Runpod cloud as a single estate. No scheduling scripts, access tickets, or per-silo tooling. + +**Consistent developer experience** + +Your team gets the same Runpod console, CLI, and APIs on the hardware you own. SSH still works. + +**Your hardware, your data, your boundary** + +You own the hardware and the data on it. Runpod orchestrates it without taking ownership. Everything you onboard is visible only to your organization. + +**No lock-in** + +The host agent uninstalls cleanly. Your workloads are standard containers. + +## Who it's for + +Runpod Hybrid Cloud is built for teams that own GPU infrastructure and want to put it to work without replatforming. + +- **Research institutions and universities**: Give researchers self-service access to the institution's GPUs, with Runpod cloud absorbing overflow when the queue is full. +- **Enterprise teams**: Unify on-prem clusters, hyperscaler reservations, and Runpod cloud under one control plane with org-scoped governance. +- **AI-native startups**: Scale on owned hardware first and burst to cloud without changing how your team deploys. + +## Security + +The host agent connects outbound only over an encrypted overlay. No inbound ports are opened. Everything onboarded is scoped to your organization and not visible to other customers. For security reviews, you get a direct line to Runpod engineers to walk the architecture. + +## Get started + +Runpod Hybrid Cloud is available to early customers, and the Runpod team works with you directly to set up your machines. [Request a demo](https://www.runpod.io/everywhere) to get started. + +## Next steps + +- [Set up external compute](/hybrid-cloud/setup). +- [Deploy Pods on your external compute](/hybrid-cloud/deploy). +- [Troubleshoot external compute](/hybrid-cloud/troubleshooting). From 40851fd6cfdd32decc83d7ff6f6c03c6351b28e7 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Mon, 28 Sep 2026 14:10:20 -0400 Subject: [PATCH 02/12] Create setup.mdx --- hybrid-cloud/setup.mdx | 55 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 hybrid-cloud/setup.mdx diff --git a/hybrid-cloud/setup.mdx b/hybrid-cloud/setup.mdx new file mode 100644 index 000000000..5d38140b4 --- /dev/null +++ b/hybrid-cloud/setup.mdx @@ -0,0 +1,55 @@ +--- +title: "Set up external compute" +sidebarTitle: "Set up external compute" +description: "Connect a machine you own to Runpod Hybrid Cloud by installing the host agent, then track it through verification until it's online." +--- + +This guide walks you through connecting a machine you own to Runpod. After you add it and install the host agent, Runpod verifies the hardware automatically. The machine is then online and available to your organization. + +## Requirements + +- An [organization](/organizations/orgs-overview) with external compute enabled. During alpha, the Runpod team enables this for you. +- An organization role that allows you to add compute. See [Roles](/organizations/org-roles). +- A single machine with at least one GPU. Multi-node machines connected by InfiniBand or a similar fabric aren't supported yet. +- SSH access to the machine, with permission to install software. + +## Add your machine + + + + In the Runpod console, go to **Resources → External compute** and click **Add compute**. + + + Select your machine type, such as an on-prem server, enter a name for the machine, and click **Next**. + + + Copy the install command shown in the console. Open an SSH session on your machine, paste the command, and run it. + + The host agent is a small program that connects your machine to Runpod over an encrypted connection that the machine opens outbound. + + + Set your machine's public and private IP addresses, open the required firewall ports, then reboot the machine. + + + Once the host agent reports in, Runpod configures the machine and runs automated hardware checks. You don't need to do anything during this step. Follow progress on the **External compute** page. + + + +## Machine statuses + +Each machine on the **External compute** page shows one of these statuses: + +| Status | What it means | +|---|---| +| Pending install | The machine has been added, but the host agent hasn't reported in yet. | +| Pending verification | The host agent is installed and the machine is registered. Runpod is preparing it for verification. | +| Verification in progress | Runpod is running automated hardware checks. | +| Online | The machine passed verification. Your team can deploy Pods on it. | +| Verification failed | The hardware checks found a problem. See [Troubleshooting](/hybrid-cloud/troubleshooting). | + +Machines you add are visible only to your organization. They aren't listed on the Runpod marketplace or made available to other customers. + +## Next steps + +- [Deploy a Pod on your external compute](/hybrid-cloud/deploy). +- [Fix verification problems](/hybrid-cloud/troubleshooting). From 7f62029fc60c8d845fba7c5fb5574dcf3b514a31 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Mon, 28 Sep 2026 14:10:59 -0400 Subject: [PATCH 03/12] Create deploy.mdx --- hybrid-cloud/deploy.mdx | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 hybrid-cloud/deploy.mdx diff --git a/hybrid-cloud/deploy.mdx b/hybrid-cloud/deploy.mdx new file mode 100644 index 000000000..26e2dcec8 --- /dev/null +++ b/hybrid-cloud/deploy.mdx @@ -0,0 +1,41 @@ +--- +title: "Deploy Pods on your external compute" +sidebarTitle: "Deploy to your compute" +description: "Deploy Pods onto the machines your organization has connected to Runpod, using the same console workflow you use for Runpod cloud." +--- + +After a machine reaches **Online**, anyone in your organization can deploy Pods on it. You use the same deploy flow you already use for Runpod cloud. The only difference is where you pick the GPU. + +## Requirements + +- At least one machine with the **Online** status. See [Set up external compute](/hybrid-cloud/setup). +- Membership in the organization that owns the machine, with permission to deploy Pods. See [Roles](/organizations/org-roles). + +## Deploy a Pod + + + + In the Runpod console, make sure your organization is selected, then go to **Pods** and click **Deploy**. + + + In the GPU picker, find the **External compute** section. It lists the GPU types available on your organization's online machines. Select the GPU you want. + + + Configure the rest of the Pod the way you normally would, including the template, storage, and environment variables. Then click **Deploy**. + + + +For details on each Pod setting, see [Manage Pods](/pods/manage-pods). + +## How placement works + +When you deploy on external compute, Runpod places the Pod on one of your organization's online machines that matches the GPU you selected. Pods deployed on your machines stay within your organization. Other Runpod customers can't deploy on them. + +## Track usage + +The **External compute** page shows how many GPUs on your machines are in use, so you can see available capacity before you deploy. + +## Next steps + +- [Troubleshoot external compute](/hybrid-cloud/troubleshooting). +- [Learn more about Pods](/pods/overview). From a9c8829935b8287fb3c9ae81fa6c2c503deb94f4 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Mon, 28 Sep 2026 14:11:41 -0400 Subject: [PATCH 04/12] Create troubleshooting.mdx --- hybrid-cloud/troubleshooting.mdx | 46 ++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 hybrid-cloud/troubleshooting.mdx diff --git a/hybrid-cloud/troubleshooting.mdx b/hybrid-cloud/troubleshooting.mdx new file mode 100644 index 000000000..6c6e79149 --- /dev/null +++ b/hybrid-cloud/troubleshooting.mdx @@ -0,0 +1,46 @@ +--- +title: "Troubleshoot external compute" +sidebarTitle: "Troubleshooting" +description: "Fix common Runpod Hybrid Cloud problems, including failed hardware verification, machines stuck in a status, and missing GPUs in the picker." +--- + +This page covers the most common problems when you connect and use external compute, and what to do about each. + +## Verification failed + +When a machine's status is **Verification failed**, the automated hardware checks found a problem with the machine or its configuration. Running verification again without changing anything gives the same result. Fix the underlying issue first, then retry verification. + +### DockerFS + +### DockerFstabUUID + +### CUDA Open Variant + +## Machine stuck in pending install + +**Pending install** means Runpod hasn't heard from the host agent yet. To fix this: + +1. Make sure the install command finished without errors. If you aren't sure, run it again. +2. Check that the machine can make outbound connections to the internet. +3. Confirm that you rebooted the machine after you configured networking. + +## Machine stuck in verification in progress + +Verification normally finishes on its own. If a machine stays in **Verification in progress** much longer than expected, the problem is most likely on the Runpod side, not your hardware. [Contact the Runpod team](#get-help) with the machine name. + +## Machine doesn't appear in the GPU picker + +If you can't find your machine's GPU when you deploy a Pod: + +- Check that the machine's status is **Online** on the **External compute** page. Machines in any other status can't accept Pods. +- Make sure you've selected the organization that owns the machine in the console. +- Check whether every GPU on your machines is already in use. The **External compute** page shows current usage. + +## Get help + +Runpod Hybrid Cloud is in alpha, and each customer works with the Runpod team during onboarding. If these steps don't fix the problem, contact your Runpod onboarding contact and include the machine name and its current status. + +## Next steps + +- [Set up external compute](/hybrid-cloud/setup). +- [Deploy Pods on your external compute](/hybrid-cloud/deploy). From 20c43ac15b801ba59cfcf19c3f943f0b2c1e60cc Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Mon, 28 Sep 2026 14:12:50 -0400 Subject: [PATCH 05/12] Update docs.json --- docs.json | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs.json b/docs.json index 987b51603..af922dcb3 100644 --- a/docs.json +++ b/docs.json @@ -283,6 +283,15 @@ } ] }, + { + "group": "Hybrid Cloud (Beta)", + "pages": [ + "hybrid-cloud/overview", + "hybrid-cloud/setup", + "hybrid-cloud/deploy", + "hybrid-cloud/troubleshooting" + ] + }, { "group": "Accounts and billing", "pages": [ From 973c7e3e32f010b5401fcfffb7284f11ae390de1 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Mon, 19 Oct 2026 14:35:44 -0400 Subject: [PATCH 06/12] Update overview.mdx --- hybrid-cloud/overview.mdx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/hybrid-cloud/overview.mdx b/hybrid-cloud/overview.mdx index 752cec55d..50756e0a4 100644 --- a/hybrid-cloud/overview.mdx +++ b/hybrid-cloud/overview.mdx @@ -8,19 +8,19 @@ Runpod Hybrid Cloud lets you bring hardware you already own under the same conso ## Requirements -Runpod Hybrid Cloud is available to organizations only. The Runpod team must enable External Compute for your org account before the feature appears in your console. [Contact us](https://www.runpod.io/everywhere) to get set up. +Runpod Hybrid Cloud is available to organizations only. The Runpod team must enable External Compute for your org account before the feature appears in your console. [Contact us](https://www.runpod.io/hybrid-cloud) to get set up. ## How it works - In the console, go to **Resources → External compute** and click **Add compute**. Select your machine type (on-prem server, AWS EC2 instance, or any cloud VM), give it a name, and click **Next**. + In the console, go to **Resources → External compute** and click **Add compute**. Give your machine a name and click **Next**. - Copy the install command that appears and paste it into an SSH session on your machine. This installs the Runpod host agent, a small program that connects your machine to Runpod over an outbound-only encrypted connection. No inbound ports are opened. Set your public and private IPs, open the required firewall ports, then reboot. For full instructions, see [Set up external compute](/hybrid-cloud/setup). + Copy the install command that appears and paste it into an SSH session on your machine. This installs the Runpod host agent, a small program that connects your machine to Runpod over an encrypted connection. Open the required firewall ports, then reboot. For full instructions, see [Set up external compute](/hybrid-cloud/setup). - Runpod runs automated hardware checks in the background. You don't need to do anything. When verification is complete, the machine's status changes to **Online** and its GPU type appears in the console. + Runpod runs automated hardware checks in the background. Verification usually takes several minutes, and you don't need to do anything. When verification is complete, the machine's status changes to **Online** and its GPU type appears in the console. Your team deploys Pods exactly as they would for any Runpod machine. An **External Compute** section appears in the GPU picker showing your available hardware. The deploy experience is identical to standard Runpod Pods. See [Deploy Pods on your external compute](/hybrid-cloud/deploy). External compute usage is tracked in the console so you can see how many GPUs are in use at any time. @@ -51,15 +51,15 @@ Runpod Hybrid Cloud is built for teams that own GPU infrastructure and want to p - **Research institutions and universities**: Give researchers self-service access to the institution's GPUs, with Runpod cloud absorbing overflow when the queue is full. - **Enterprise teams**: Unify on-prem clusters, hyperscaler reservations, and Runpod cloud under one control plane with org-scoped governance. -- **AI-native startups**: Scale on owned hardware first and burst to cloud without changing how your team deploys. +- **AI-native startups**: Focus on your core product instead of building your own abstraction across compute providers. Runpod gives you a provider-agnostic API layer out of the box, so you can run on your own hardware first and burst to Runpod cloud without changing how your team deploys. ## Security -The host agent connects outbound only over an encrypted overlay. No inbound ports are opened. Everything onboarded is scoped to your organization and not visible to other customers. For security reviews, you get a direct line to Runpod engineers to walk the architecture. +The host agent connects your machine to Runpod over an encrypted overlay network. Everything you onboard is scoped to your organization and isn't visible to other customers. For network requirements, see [Set up external compute](/hybrid-cloud/setup#requirements). For security reviews, you get a direct line to Runpod engineers to walk the architecture. ## Get started -Runpod Hybrid Cloud is available to early customers, and the Runpod team works with you directly to set up your machines. [Request a demo](https://www.runpod.io/everywhere) to get started. +Runpod Hybrid Cloud is available to early customers, and the Runpod team works with you directly to set up your machines. [Request a demo](https://www.runpod.io/hybrid-cloud) to get started. ## Next steps From 9c2d4abad0d354ebfdbaea02d9a2f59336e7fc04 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Mon, 19 Oct 2026 14:38:44 -0400 Subject: [PATCH 07/12] Update setup.mdx --- hybrid-cloud/setup.mdx | 25 ++++++++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) diff --git a/hybrid-cloud/setup.mdx b/hybrid-cloud/setup.mdx index 5d38140b4..175f19180 100644 --- a/hybrid-cloud/setup.mdx +++ b/hybrid-cloud/setup.mdx @@ -13,6 +13,18 @@ This guide walks you through connecting a machine you own to Runpod. After you a - A single machine with at least one GPU. Multi-node machines connected by InfiniBand or a similar fabric aren't supported yet. - SSH access to the machine, with permission to install software. +Your machine must also meet these hardware and network requirements: + +| Requirement | Value | +|---|---| +| Operating system | Ubuntu 24.04, with a kernel from 6.8 through 7.0.x. | +| GPU drivers | None preinstalled. The Runpod installer manages GPU drivers. | +| Root disk | At least 200 GB. | +| Docker disk | A dedicated disk of at least 600 GB. | +| Disk throughput | At least 150 MB/s. | +| Outbound network | All TCP, UDP 4242 (Runpod control plane), UDP 53 (DNS), UDP 123 (time sync), and ICMP echo. | +| Inbound network | TCP 10000–60000. | + ## Add your machine @@ -20,7 +32,11 @@ This guide walks you through connecting a machine you own to Runpod. After you a In the Runpod console, go to **Resources → External compute** and click **Add compute**. - Select your machine type, such as an on-prem server, enter a name for the machine, and click **Next**. + Enter a name for the machine and click **Next**. + + + Use only lowercase letters, numbers, and hyphens in the machine name. The name can't start or end with a hyphen, and can't contain underscores. + Copy the install command shown in the console. Open an SSH session on your machine, paste the command, and run it. @@ -28,10 +44,10 @@ This guide walks you through connecting a machine you own to Runpod. After you a The host agent is a small program that connects your machine to Runpod over an encrypted connection that the machine opens outbound. - Set your machine's public and private IP addresses, open the required firewall ports, then reboot the machine. + In the same onboarding window that shows the install command, copy the networking command and paste it into your SSH session. The command sets your machine's public and private IP addresses. Make sure the ports listed in [Requirements](#requirements) are open, then reboot the machine. - Once the host agent reports in, Runpod configures the machine and runs automated hardware checks. You don't need to do anything during this step. Follow progress on the **External compute** page. + Once the host agent reports in, Runpod configures the machine and runs automated hardware checks. Verification usually takes several minutes, and you don't need to do anything during this step. Follow progress on the **External compute** page. @@ -46,6 +62,9 @@ Each machine on the **External compute** page shows one of these statuses: | Verification in progress | Runpod is running automated hardware checks. | | Online | The machine passed verification. Your team can deploy Pods on it. | | Verification failed | The hardware checks found a problem. See [Troubleshooting](/hybrid-cloud/troubleshooting). | +| Verification timed out | Runpod couldn't connect to the machine to run the hardware checks. See [Troubleshooting](/hybrid-cloud/troubleshooting#verification-timed-out). | +| Offline | Runpod can't reach the machine's host agent. | +| Under maintenance | The machine is temporarily not accepting new Pods. | Machines you add are visible only to your organization. They aren't listed on the Runpod marketplace or made available to other customers. From 0129f46db7f00d33715ce115d24cc4a72388f091 Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Mon, 19 Oct 2026 14:45:57 -0400 Subject: [PATCH 08/12] Update troubleshooting.mdx --- hybrid-cloud/troubleshooting.mdx | 44 ++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) diff --git a/hybrid-cloud/troubleshooting.mdx b/hybrid-cloud/troubleshooting.mdx index 6c6e79149..b9c011669 100644 --- a/hybrid-cloud/troubleshooting.mdx +++ b/hybrid-cloud/troubleshooting.mdx @@ -10,12 +10,56 @@ This page covers the most common problems when you connect and use external comp When a machine's status is **Verification failed**, the automated hardware checks found a problem with the machine or its configuration. Running verification again without changing anything gives the same result. Fix the underlying issue first, then retry verification. +To see which checks failed, open the machine on the **External compute** page and go to the **Verifications** tab. + ### DockerFS +The disk mounted at `/var/lib/docker` is too small. The failure message shows the size it found and the size it requires. + +To fix this, mount a dedicated disk that meets the Docker disk size in [Requirements](/hybrid-cloud/setup#requirements) at `/var/lib/docker`, then retry verification. + ### DockerFstabUUID +The Docker disk is mounted in `/etc/fstab` by its device name, such as `/dev/sdb` or `/dev/md0`, instead of by its UUID. Device names can change when the machine reboots, which can stop the Docker disk from mounting. + +To fix this: + +1. Find the UUID of the Docker disk: + + ```bash + sudo blkid + ``` + +2. In `/etc/fstab`, replace the device name on the `/var/lib/docker` line with the UUID. For example: + + ```text + UUID=DISK_UUID /var/lib/docker xfs defaults 0 0 + ``` + +3. Check that the disk mounts correctly, then retry verification: + + ```bash + sudo mount -a + ``` + ### CUDA Open Variant +The machine has the wrong variant of the NVIDIA driver installed, usually the server variant packages. Runpod requires the open kernel module variant, and the Runpod installer installs the driver for you. + +To fix this, remove any NVIDIA driver packages you installed before onboarding, reboot the machine, and retry verification. To see which NVIDIA packages are installed, run: + +```bash +dpkg -l | grep nvidia +``` + +## Verification timed out + +**Verification timed out** means Runpod couldn't connect to your machine to run the hardware checks. To fix this: + +1. Make sure `sshd` is listening on all network interfaces, not only on localhost. +2. Check that your firewall allows the inbound and outbound traffic listed in [Requirements](/hybrid-cloud/setup#requirements). +3. Retry verification. + ## Machine stuck in pending install **Pending install** means Runpod hasn't heard from the host agent yet. To fix this: From 79f6ef7fc2f17badeecf04d092f61936b166d75f Mon Sep 17 00:00:00 2001 From: lgunreddi Date: Mon, 19 Oct 2026 14:48:13 -0400 Subject: [PATCH 09/12] Update deploy.mdx --- hybrid-cloud/deploy.mdx | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/hybrid-cloud/deploy.mdx b/hybrid-cloud/deploy.mdx index 26e2dcec8..809b7e9fd 100644 --- a/hybrid-cloud/deploy.mdx +++ b/hybrid-cloud/deploy.mdx @@ -21,15 +21,13 @@ After a machine reaches **Online**, anyone in your organization can deploy Pods In the GPU picker, find the **External compute** section. It lists the GPU types available on your organization's online machines. Select the GPU you want. - Configure the rest of the Pod the way you normally would, including the template, storage, and environment variables. Then click **Deploy**. + Configure the rest of the Pod the way you normally would, including the template, storage, and environment variables. Then click **Deploy**. For details on each Pod setting, see [Manage Pods](/pods/manage-pods). -For details on each Pod setting, see [Manage Pods](/pods/manage-pods). - ## How placement works -When you deploy on external compute, Runpod places the Pod on one of your organization's online machines that matches the GPU you selected. Pods deployed on your machines stay within your organization. Other Runpod customers can't deploy on them. +When you deploy on external compute, Runpod places the Pod on one of your organization's online machines that matches the GPU you selected. Pods deployed on your machines stay within your organization. Other Runpod customers can't deploy to them. ## Track usage From e515f3e9aa00f31ee31e61fc10ab64b191415b41 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Thu, 22 Oct 2026 19:03:47 +0000 Subject: [PATCH 10/12] Update Hybrid Cloud availability wording in overview --- hybrid-cloud/overview.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hybrid-cloud/overview.mdx b/hybrid-cloud/overview.mdx index 50756e0a4..769c8b9df 100644 --- a/hybrid-cloud/overview.mdx +++ b/hybrid-cloud/overview.mdx @@ -59,7 +59,7 @@ The host agent connects your machine to Runpod over an encrypted overlay network ## Get started -Runpod Hybrid Cloud is available to early customers, and the Runpod team works with you directly to set up your machines. [Request a demo](https://www.runpod.io/hybrid-cloud) to get started. +Runpod Hybrid Cloud is in alpha and available to select customers, and the Runpod team works with you directly to set up your machines. [Request a demo](https://www.runpod.io/hybrid-cloud) to get started. ## Next steps From 40e1daf22eebb24423a68d86bbd1af528887e5ea Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Thu, 22 Oct 2026 19:50:11 +0000 Subject: [PATCH 11/12] Add verification timing note and correct inbound ports for Hybrid Cloud --- hybrid-cloud/setup.mdx | 2 +- hybrid-cloud/troubleshooting.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/hybrid-cloud/setup.mdx b/hybrid-cloud/setup.mdx index 175f19180..716d85f35 100644 --- a/hybrid-cloud/setup.mdx +++ b/hybrid-cloud/setup.mdx @@ -23,7 +23,7 @@ Your machine must also meet these hardware and network requirements: | Docker disk | A dedicated disk of at least 600 GB. | | Disk throughput | At least 150 MB/s. | | Outbound network | All TCP, UDP 4242 (Runpod control plane), UDP 53 (DNS), UDP 123 (time sync), and ICMP echo. | -| Inbound network | TCP 10000–60000. | +| Inbound network | TCP 10000 and 20000. | ## Add your machine diff --git a/hybrid-cloud/troubleshooting.mdx b/hybrid-cloud/troubleshooting.mdx index b9c011669..5a58ed221 100644 --- a/hybrid-cloud/troubleshooting.mdx +++ b/hybrid-cloud/troubleshooting.mdx @@ -70,7 +70,7 @@ dpkg -l | grep nvidia ## Machine stuck in verification in progress -Verification normally finishes on its own. If a machine stays in **Verification in progress** much longer than expected, the problem is most likely on the Runpod side, not your hardware. [Contact the Runpod team](#get-help) with the machine name. +Verification usually completes within 30 minutes. If a machine stays in **Verification in progress** for longer than that, [contact Runpod support](#get-help) with the machine name, and they'll help you complete verification. ## Machine doesn't appear in the GPU picker From 7ff7d8b85445631f6e27f6264515533a3ddc0c73 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Thu, 22 Oct 2026 20:14:01 +0000 Subject: [PATCH 12/12] Rename "host agent" to "host connector" in Hybrid Cloud docs --- hybrid-cloud/overview.mdx | 8 ++++---- hybrid-cloud/setup.mdx | 16 ++++++++-------- hybrid-cloud/troubleshooting.mdx | 2 +- 3 files changed, 13 insertions(+), 13 deletions(-) diff --git a/hybrid-cloud/overview.mdx b/hybrid-cloud/overview.mdx index 769c8b9df..6b1d94445 100644 --- a/hybrid-cloud/overview.mdx +++ b/hybrid-cloud/overview.mdx @@ -16,8 +16,8 @@ Runpod Hybrid Cloud is available to organizations only. The Runpod team must ena In the console, go to **Resources → External compute** and click **Add compute**. Give your machine a name and click **Next**. - - Copy the install command that appears and paste it into an SSH session on your machine. This installs the Runpod host agent, a small program that connects your machine to Runpod over an encrypted connection. Open the required firewall ports, then reboot. For full instructions, see [Set up external compute](/hybrid-cloud/setup). + + Copy the install command that appears and paste it into an SSH session on your machine. This installs the Runpod host connector, a small program that connects your machine to Runpod over an encrypted connection. Open the required firewall ports, then reboot. For full instructions, see [Set up external compute](/hybrid-cloud/setup). Runpod runs automated hardware checks in the background. Verification usually takes several minutes, and you don't need to do anything. When verification is complete, the machine's status changes to **Online** and its GPU type appears in the console. @@ -43,7 +43,7 @@ You own the hardware and the data on it. Runpod orchestrates it without taking o **No lock-in** -The host agent uninstalls cleanly. Your workloads are standard containers. +The host connector uninstalls cleanly. Your workloads are standard containers. ## Who it's for @@ -55,7 +55,7 @@ Runpod Hybrid Cloud is built for teams that own GPU infrastructure and want to p ## Security -The host agent connects your machine to Runpod over an encrypted overlay network. Everything you onboard is scoped to your organization and isn't visible to other customers. For network requirements, see [Set up external compute](/hybrid-cloud/setup#requirements). For security reviews, you get a direct line to Runpod engineers to walk the architecture. +The host connector connects your machine to Runpod over an encrypted overlay network. Everything you onboard is scoped to your organization and isn't visible to other customers. For network requirements, see [Set up external compute](/hybrid-cloud/setup#requirements). For security reviews, you get a direct line to Runpod engineers to walk the architecture. ## Get started diff --git a/hybrid-cloud/setup.mdx b/hybrid-cloud/setup.mdx index 716d85f35..278428d63 100644 --- a/hybrid-cloud/setup.mdx +++ b/hybrid-cloud/setup.mdx @@ -1,10 +1,10 @@ --- title: "Set up external compute" sidebarTitle: "Set up external compute" -description: "Connect a machine you own to Runpod Hybrid Cloud by installing the host agent, then track it through verification until it's online." +description: "Connect a machine you own to Runpod Hybrid Cloud by installing the host connector, then track it through verification until it's online." --- -This guide walks you through connecting a machine you own to Runpod. After you add it and install the host agent, Runpod verifies the hardware automatically. The machine is then online and available to your organization. +This guide walks you through connecting a machine you own to Runpod. After you add it and install the host connector, Runpod verifies the hardware automatically. The machine is then online and available to your organization. ## Requirements @@ -38,16 +38,16 @@ Your machine must also meet these hardware and network requirements: Use only lowercase letters, numbers, and hyphens in the machine name. The name can't start or end with a hyphen, and can't contain underscores. - + Copy the install command shown in the console. Open an SSH session on your machine, paste the command, and run it. - The host agent is a small program that connects your machine to Runpod over an encrypted connection that the machine opens outbound. + The host connector is a small program that connects your machine to Runpod over an encrypted connection that the machine opens outbound. In the same onboarding window that shows the install command, copy the networking command and paste it into your SSH session. The command sets your machine's public and private IP addresses. Make sure the ports listed in [Requirements](#requirements) are open, then reboot the machine. - Once the host agent reports in, Runpod configures the machine and runs automated hardware checks. Verification usually takes several minutes, and you don't need to do anything during this step. Follow progress on the **External compute** page. + Once the host connector reports in, Runpod configures the machine and runs automated hardware checks. Verification usually takes several minutes, and you don't need to do anything during this step. Follow progress on the **External compute** page. @@ -57,13 +57,13 @@ Each machine on the **External compute** page shows one of these statuses: | Status | What it means | |---|---| -| Pending install | The machine has been added, but the host agent hasn't reported in yet. | -| Pending verification | The host agent is installed and the machine is registered. Runpod is preparing it for verification. | +| Pending install | The machine has been added, but the host connector hasn't reported in yet. | +| Pending verification | The host connector is installed and the machine is registered. Runpod is preparing it for verification. | | Verification in progress | Runpod is running automated hardware checks. | | Online | The machine passed verification. Your team can deploy Pods on it. | | Verification failed | The hardware checks found a problem. See [Troubleshooting](/hybrid-cloud/troubleshooting). | | Verification timed out | Runpod couldn't connect to the machine to run the hardware checks. See [Troubleshooting](/hybrid-cloud/troubleshooting#verification-timed-out). | -| Offline | Runpod can't reach the machine's host agent. | +| Offline | Runpod can't reach the machine's host connector. | | Under maintenance | The machine is temporarily not accepting new Pods. | Machines you add are visible only to your organization. They aren't listed on the Runpod marketplace or made available to other customers. diff --git a/hybrid-cloud/troubleshooting.mdx b/hybrid-cloud/troubleshooting.mdx index 5a58ed221..cac420766 100644 --- a/hybrid-cloud/troubleshooting.mdx +++ b/hybrid-cloud/troubleshooting.mdx @@ -62,7 +62,7 @@ dpkg -l | grep nvidia ## Machine stuck in pending install -**Pending install** means Runpod hasn't heard from the host agent yet. To fix this: +**Pending install** means Runpod hasn't heard from the host connector yet. To fix this: 1. Make sure the install command finished without errors. If you aren't sure, run it again. 2. Check that the machine can make outbound connections to the internet.