WARNING:
VMs interface much more directly with hardware than Docker containers.
Proper VM support is very sensitive to hardware setup.
This guide covers the configuration steps needed to enable support for Vast VMs on most setups, but is not and cannot be exhausitve.
Vast now supports VM instances running on Kernel Virtual Machine (KVM) in addition to Docker container based instances.
VM support is currently an optional feature for hosts as it usually requires additional configuration steps on top of those needed to support Docker-based instances.Host machines are not required to be VM compatible; the Vast hosting software will automatically test and enable the feature on machines on which VMs are supported.
On new machines the tests will be run on install; for machines configured before the VM-feature release, testing for VM-compatability will happen when the machine is unoccupied.Machines that do not have VM support enabled will be hidden in the search page for clients who have VM-based templates selected.
VM support will allow your machine to take advantage of demand for use cases that Docker cannot easily support, in addition to demand for conventional Docker-based instances.VMs support the following features/use-cases that Docker-based instances do not:
Feature
Use-case
Systemd/Docker
Multi-Application Server Tooling and DevOps (e.g., Docker Compose, Kubernetes, Docker Build)
Non-Linux OSes
Windows Graphics (e.g., for rendering or cloud gaming)
ptrace
Program analysis for CUDA-performance optimization (e.g., via Nvidia NSight)
Currently no other peer-to-peer GPU rental marketplace offers full VMs; instead full VMs are only available from traditional providers at much higher costs.
Thus we believe that hosts who have VMs enabled can expect to command a substantial preumium.
Due to greater user control over hardware, VM support requires IOMMU settings for securing PCIe communications that can degrade the performance of NCCL on non-RTX 40X0 multi-GPU machines that rely on PCI-based GPU peer-to-peer communication.
VMs require more disk space than Docker containers as they do not share components with the host OS. Hosts with VMs enabled may want to set higher disk prices.
VMs cannot earn revenue from bandwidth. Bandwidth revenue is only earned from Docker-based instances.
We recommend all hosts with single-GPU rigs to try to ensure VM support as the drawbacks for single-GPU machines are minimal.We also generally recommend multi-GPU Hosts with RTX 40X0 series GPUs try enabling VMs, especially if they have plentiful disk space and fast (500Mbps+) internet speed,
as rendering/gaming users will benefit from those, as well as users who need multi-application orchestration tools.We do not recommend multi-GPU hosts with datacenter GPUs enable VMs until we can ensure better GPU P2P communication support in VMs, including support for NVLink.
To prevent VMs from being enabled on your machine, or to disable VMs after they have been enabled, run python3 /var/lib/vastai_kaalia/enable_vms.py off.Note that default configuration settings for most machines will not support VMs, and we can detect that, so most hosts who do not want VMs enabled do not need to take any action.
For further reference refer to Preparing the IOMMU.We will need to ensure IOMMU, a technology that secures and isolates communication between PCIe devices, is set up, along with disabling all driver features that interfere with VMs.Open /etc/default/grub and add to the GRUB_CMDLINE_LINUX= the following:
amd_iommu=on or intel_iommu=on depending on whether you have an AMD or Intel CPU.
nvidia_drm.modeset=0
Some hosts may also need to add the following settings:
If you have a display manager (e.g., GDM) or display server (XOrg, Wayland, etc) running, you must disable them.You may not run any background GPU processes for VMs to work (nvidia-persitenced is OK, it is managed by our hosting software).
We will check/test your configuration when your machine is idle and enable VMs by default if your machine is capable of supporting VMs, and you have not set VMs to off.If you have VMs set to off, and you’d like to retry enabling VMs, run sudo python3 /var/lib/vastai_kaalia/enable_vms.py on -f while your machine is idle.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vast.ai Documentation: Affordable GPU Cloud Marketplace","colors":{"primary":"#315FFF","light":"#315FFF","dark":"#315FFF"},"logo":{"light":"https://mintcdn.com/vastai-80aa3a82/lDYZh_6OFg5OOaSN/logo/light.svg?fit=max\u0026auto=format\u0026n=lDYZh_6OFg5OOaSN\u0026q=85\u0026s=7f79454b79a0cfc463ec063cd29faea0","dark":"https://mintcdn.com/vastai-80aa3a82/lDYZh_6OFg5OOaSN/logo/dark.svg?fit=max\u0026auto=format\u0026n=lDYZh_6OFg5OOaSN\u0026q=85\u0026s=a0ab9c5200d0f126bb744a83bc1b1ee2"},"favicon":"https://mintcdn.com/vastai-80aa3a82/1e4lY_zkN1CU9p24/favicon.svg?fit=max\u0026auto=format\u0026n=1e4lY_zkN1CU9p24\u0026q=85\u0026s=0d6a4623043c830bd4703fe39c7c8dc3","navbar":{"links":[{"href":"/guides/reference/faq","label":"FAQ"},{"href":"https://discord.gg/vast","label":"Discord"}],"primary":{"type":"button","label":"Console","href":"https://cloud.vast.ai/"}},"footer":{"socials":{"x":"https://x.com/vast_ai","github":"https://github.com/vast-ai","youtube":"https://www.youtube.com/@vast_ai/videos"}},"seo":{"metatags":{"indexing":"all","author":"Vast.ai Team","robots":"index, follow","googlebot":"index, follow","google":"notranslate","google-site-verification":"WHKqvZxf1snX5HX4y0luN_AnAvAPGoSjUcMv03b_NsI","generator":"Mintlify","theme-color":"#000000","color-scheme":"light dark","format-detection":"telephone=no","referrer":"origin","rating":"general","revisit-after":"7 days","language":"en","copyright":"Copyright 2025","reply-to":"contact@vast.ai","distribution":"global","coverage":"Worldwide","category":"Developer Documentation","target":"all","HandheldFriendly":"True","MobileOptimized":"320","apple-mobile-web-app-capable":"yes","apple-mobile-web-app-status-bar-style":"black","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@vast_ai","twitter:creator":"@vast_ai"}},"integrations":{"ga4":{"measurementId":"G-DG15WC8WXG"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vastai-80aa3a82","hasAudioNarration":false,"actualSubdomain":"vastai-80aa3a82","customDomains":["docs.vast.ai"],"gitSource":{"type":"github","owner":"vast-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adfbe11db56f9a377f1e85d","collectionId":"19df4429-5845-44de-b641-dfaf4afb19cb","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adfbe11db56f9a377f1e85d"},"feedback":{"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adfc284cade0989ea623e30","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"CLI \u0026 SDK","count":258},{"language":"default","tag":"CLI","count":148},{"language":"default","tag":"SDK","count":143},{"language":"default","tag":"API","count":108},{"language":"default","tag":"Guides","count":101},{"language":"default","tag":"Endpoints","count":100},{"language":"default","tag":"Instances","count":94},{"language":"default","tag":"Host","count":87},{"language":"default","tag":"Serverless","count":80},{"language":"default","tag":"Accounts","count":58}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@media (min-width:1024px){div:has(>nav#sidebar){max-width:none!important}#navbar>div{max-width:none!important}#content-area>#content,#content-area>#header{max-width:900px;margin-left:auto;margin-right:auto}}.table-column-dividers td+td,.table-column-dividers th+th{border-left:1px solid color-mix(in srgb,currentColor 20%,transparent)}"}],"page":{"pagePath":"host/vms","slug":"/host/vms","pageMetadata":{"title":"VMs","createdAt":"Mon Jan 13 2025 21:20:40 GMT+0000 (Coordinated Universal Time)","updatedAt":"Wed Jan 15 2025 00:37:08 GMT+0000 (Coordinated Universal Time)","description":null,"href":"/host/vms"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`WARNING:`}),`\nVMs interface much more directly with hardware than Docker containers.\nProper VM support is very sensitive to hardware setup.\nThis guide covers the configuration steps needed to enable support for Vast VMs on most setups, but is not and cannot be exhausitve.`]})}),`\n`,_jsx(Heading,{level:`1`,id:`introduction`,children:`Introduction`}),`\n`,_jsx(_components.p,{children:`Vast now supports VM instances running on Kernel Virtual Machine (KVM) in addition to Docker container based instances.\nVM support is currently an optional feature for hosts as it usually requires additional configuration steps on top of those needed to support Docker-based instances.`}),`\n`,_jsx(_components.p,{children:`Host machines are not required to be VM compatible; the Vast hosting software will automatically test and enable the feature on machines on which VMs are supported.\nOn new machines the tests will be run on install; for machines configured before the VM-feature release, testing for VM-compatability will happen when the machine is unoccupied.`}),`\n`,_jsx(_components.p,{children:`Machines that do not have VM support enabled will be hidden in the search page for clients who have VM-based templates selected.`}),`\n`,_jsx(Heading,{level:`2`,id:`vm-support-benefits/drawbacks`,children:`VM Support Benefits/Drawbacks`}),`\n`,_jsx(Heading,{level:`3`,id:`benefits`,children:`Benefits`}),`\n`,_jsx(_components.p,{children:`VM support will allow your machine to take advantage of demand for use cases that Docker cannot easily support, in addition to demand for conventional Docker-based instances.`}),`\n`,_jsx(_components.p,{children:`VMs support the following features/use-cases that Docker-based instances do not:`}),`\n`,_jsx(`div`,{className:`table-column-dividers`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Feature`}),_jsx(_components.th,{children:`Use-case`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Systemd/Docker`}),_jsx(_components.td,{children:`Multi-Application Server Tooling and DevOps (e.g., Docker Compose, Kubernetes, Docker Build)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Non-Linux OSes`}),_jsx(_components.td,{children:`Windows Graphics (e.g., for rendering or cloud gaming)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`ptrace`}),_jsx(_components.td,{children:`Program analysis for CUDA-performance optimization (e.g., via Nvidia NSight)`})]})]})]})}),`\n`,_jsx(_components.p,{children:`Currently no other peer-to-peer GPU rental marketplace offers full VMs; instead full VMs are only available from traditional providers at much higher costs.\nThus we believe that hosts who have VMs enabled can expect to command a substantial preumium.`}),`\n`,_jsx(Heading,{level:`3`,id:`drawbacks`,children:`Drawbacks`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Due to greater user control over hardware, VM support requires IOMMU settings for securing PCIe communications that can degrade the performance of NCCL on non-RTX 40X0 multi-GPU machines that rely on PCI-based GPU peer-to-peer communication.`}),`\n`,_jsx(_components.li,{children:`VMs require more disk space than Docker containers as they do not share components with the host OS. Hosts with VMs enabled may want to set higher disk prices.`}),`\n`,_jsx(_components.li,{children:`VMs cannot earn revenue from bandwidth. Bandwidth revenue is only earned from Docker-based instances.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`summary`,children:`Summary`}),`\n`,_jsx(_components.p,{children:`We recommend all hosts with single-GPU rigs to try to ensure VM support as the drawbacks for single-GPU machines are minimal.`}),`\n`,_jsx(_components.p,{children:`We also generally recommend multi-GPU Hosts with RTX 40X0 series GPUs try enabling VMs, especially if they have plentiful disk space and fast (500Mbps+) internet speed,\nas rendering/gaming users will benefit from those, as well as users who need multi-application orchestration tools.`}),`\n`,_jsx(_components.p,{children:`We do not recommend multi-GPU hosts with datacenter GPUs enable VMs until we can ensure better GPU P2P communication support in VMs, including support for NVLink.`}),`\n`,_jsx(Heading,{level:`2`,id:`configuring-vms-on-your-machine`,children:`Configuring VMs on your machine`}),`\n`,_jsx(Heading,{level:`3`,id:`checking-vm-enablement-status`,children:`Checking VM enablement status.`}),`\n`,_jsxs(_components.p,{children:[`Run `,_jsx(_components.code,{children:`python3 /var/lib/vastai_kaalia/enable_vms.py check`}),`.`]}),`\n`,_jsx(_components.p,{children:`Possible results are:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`on`}),`: VMs are enabled on your machine.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`off`}),`: VMs are disabled on your machine. Either you disabled VMs or our previous tests failed.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`pending`}),`: VMs are not disabled, but will try to enable once the machine is idle.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`disabling-vms`,children:`Disabling VMs.`}),`\n`,_jsxs(_components.p,{children:[`To prevent VMs from being enabled on your machine, or to disable VMs after they have been enabled, run `,_jsx(_components.code,{children:`python3 /var/lib/vastai_kaalia/enable_vms.py off`}),`.`]}),`\n`,_jsx(_components.p,{children:`Note that default configuration settings for most machines will not support VMs, and we can detect that, so most hosts who do not want VMs enabled do not need to take any action.`}),`\n`,_jsx(Heading,{level:`3`,id:`configuring-your-machine-to-support-vms`,children:`Configuring your machine to support VMs.`}),`\n`,_jsx(Heading,{level:`3`,id:`hardware-prerequisites`,children:`Hardware prerequisites`}),`\n`,_jsx(_components.p,{children:`You will require a CPU and a chipset that support Intel VT-d or AMD-Vi.`}),`\n`,_jsx(Heading,{level:`3`,id:`configure-bios`,children:`Configure BIOS`}),`\n`,_jsx(_components.p,{children:`Check that virtualization is enabled in your BIOS. On most machines, this should be enabled by default.`}),`\n`,_jsx(Heading,{level:`3`,id:`configure-kernel-commandline-arguments`,children:`Configure Kernel Commandline Arguments`}),`\n`,_jsxs(_components.p,{children:[`For further reference refer to `,_jsx(_components.a,{href:`https://ubuntu.com/server/docs/gpu-virtualization-with-qemu-kvm#preparing-the-input-output-memory-management-unit-iommu`,children:`Preparing the IOMMU`}),`.`]}),`\n`,_jsx(_components.p,{children:`We will need to ensure IOMMU, a technology that secures and isolates communication between PCIe devices, is set up, along with disabling all driver features that interfere with VMs.`}),`\n`,_jsxs(_components.p,{children:[`Open `,_jsx(_components.code,{children:`/etc/default/grub`}),` and add to the `,_jsx(_components.code,{children:`GRUB_CMDLINE_LINUX=`}),` the following:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`amd_iommu=on`}),` or `,_jsx(_components.code,{children:`intel_iommu=on`}),` depending on whether you have an AMD or Intel CPU.`]}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`nvidia_drm.modeset=0`})}),`\n`]}),`\n`,_jsx(_components.p,{children:`Some hosts may also need to add the following settings:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`rd.driver.blacklist=nouveau`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`modprobe.blacklist=nouveau`})}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Then run `,_jsx(_components.code,{children:`sudo update-grub`}),` and reboot.`]}),`\n`,_jsx(Heading,{level:`3`,id:`disable-display-managers/background-gpu-processes`,children:`Disable display managers/background GPU processes.`}),`\n`,_jsx(_components.p,{children:`If you have a display manager (e.g., GDM) or display server (XOrg, Wayland, etc) running, you must disable them.`}),`\n`,_jsxs(_components.p,{children:[`You may not run any background GPU processes for VMs to work (`,_jsx(_components.code,{children:`nvidia-persitenced`}),` is OK, it is managed by our hosting software).`]}),`\n`,_jsx(Heading,{level:`3`,id:`enabling-vms`,children:`Enabling VMs`}),`\n`,_jsxs(_components.p,{children:[`We will check/test your configuration when your machine is idle and enable VMs by default if your machine is capable of supporting VMs, and you have not set VMs to `,_jsx(_components.code,{children:`off`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`If you have VMs set to off, and you’d like to retry enabling VMs, run `,_jsx(_components.code,{children:`sudo python3 /var/lib/vastai_kaalia/enable_vms.py on -f`}),` while your machine is idle.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"VMs","createdAt":"Mon Jan 13 2025 21:20:40 GMT+0000 (Coordinated Universal Time)","updatedAt":"Wed Jan 15 2025 00:37:08 GMT+0000 (Coordinated Universal Time)","description":null,"href":"/host/vms"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Introduction","slug":"introduction","depth":1,"children":[]},{"title":"VM Support Benefits/Drawbacks","slug":"vm-support-benefits/drawbacks","depth":2,"children":[{"title":"Benefits","slug":"benefits","depth":3,"children":[]},{"title":"Drawbacks","slug":"drawbacks","depth":3,"children":[]},{"title":"Summary","slug":"summary","depth":3,"children":[]}]},{"title":"Configuring VMs on your machine","slug":"configuring-vms-on-your-machine","depth":2,"children":[{"title":"Checking VM enablement status.","slug":"checking-vm-enablement-status","depth":3,"children":[]},{"title":"Disabling VMs.","slug":"disabling-vms","depth":3,"children":[]},{"title":"Configuring your machine to support VMs.","slug":"configuring-your-machine-to-support-vms","depth":3,"children":[]},{"title":"Hardware prerequisites","slug":"hardware-prerequisites","depth":3,"children":[]},{"title":"Configure BIOS","slug":"configure-bios","depth":3,"children":[]},{"title":"Configure Kernel Commandline Arguments","slug":"configure-kernel-commandline-arguments","depth":3,"children":[]},{"title":"Disable display managers/background GPU processes.","slug":"disable-display-managers/background-gpu-processes","depth":3,"children":[]},{"title":"Enabling VMs","slug":"enabling-vms","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/vastai-80aa3a82/54e4ee435ab02cb8/structured-data.js"],"subdomain":"vastai-80aa3a82","siteName":"Vast.ai Documentation: Affordable GPU Cloud Marketplace","title":"VMs - Vast.ai Documentation: Affordable GPU Cloud Marketplace","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T21:15:13.407Z","originalFileLocation":"host/vms.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Vast.ai Documentation: Affordable GPU Cloud Marketplace\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vastai-80aa3a82/Xpia3h5CJX2PzgYG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/vastai-80aa3a82/Xpia3h5CJX2PzgYG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vastai-80aa3a82/Xpia3h5CJX2PzgYG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/vastai-80aa3a82/Xpia3h5CJX2PzgYG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/vastai-80aa3a82/Xpia3h5CJX2PzgYG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vastai-80aa3a82/Xpia3h5CJX2PzgYG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vastai-80aa3a82/Xpia3h5CJX2PzgYG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/vastai-80aa3a82/Xpia3h5CJX2PzgYG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/vastai-80aa3a82/Xpia3h5CJX2PzgYG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"VMs - Vast.ai Documentation: Affordable GPU Cloud Marketplace\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vast.ai Documentation: Affordable GPU Cloud Marketplace\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vast.ai/host/vms\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vastai-80aa3a82.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=VMs\u0026amp;theme=bf5e39208aeafab2e44b0496\u0026amp;signature=0592fcbff604d1d2bc91f19de3fd9e7a77c428e37bf5bc70ecdddfb2fc3dda4e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"VMs - Vast.ai Documentation: Affordable GPU Cloud Marketplace\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vastai-80aa3a82.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=VMs\u0026amp;theme=bf5e39208aeafab2e44b0496\u0026amp;signature=0592fcbff604d1d2bc91f19de3fd9e7a77c428e37bf5bc70ecdddfb2fc3dda4e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/vastai-80aa3a82/Xpia3h5CJX2PzgYG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vast.ai Documentation: Affordable GPU Cloud Marketplace\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#315FFF\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"indexing\" content=\"all\">\u003cmeta data-mint-head name=\"author\" content=\"Vast.ai Team\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003cmeta data-mint-head name=\"google\" content=\"notranslate\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"WHKqvZxf1snX5HX4y0luN_AnAvAPGoSjUcMv03b_NsI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#000000\">\u003cmeta data-mint-head name=\"color-scheme\" content=\"light dark\">\u003cmeta data-mint-head name=\"format-detection\" content=\"telephone=no\">\u003cmeta data-mint-head name=\"referrer\" content=\"origin\">\u003cmeta data-mint-head name=\"rating\" content=\"general\">\u003cmeta data-mint-head name=\"revisit-after\" content=\"7 days\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003cmeta data-mint-head name=\"copyright\" content=\"Copyright 2025\">\u003cmeta data-mint-head name=\"reply-to\" content=\"contact@vast.ai\">\u003cmeta data-mint-head name=\"distribution\" content=\"global\">\u003cmeta data-mint-head name=\"coverage\" content=\"Worldwide\">\u003cmeta data-mint-head name=\"category\" content=\"Developer Documentation\">\u003cmeta data-mint-head name=\"target\" content=\"all\">\u003cmeta data-mint-head name=\"HandheldFriendly\" content=\"True\">\u003cmeta data-mint-head name=\"MobileOptimized\" content=\"320\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-capable\" content=\"yes\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-status-bar-style\" content=\"black\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@vast_ai\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vast.ai/host/vms\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/host/vms.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vast.ai/#organization\",\"name\":\"Vast.ai Documentation: Affordable GPU Cloud Marketplace\",\"url\":\"https://docs.vast.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vastai-80aa3a82/lDYZh_6OFg5OOaSN/logo/light.svg?fit=max\u0026auto=format\u0026n=lDYZh_6OFg5OOaSN\u0026q=85\u0026s=7f79454b79a0cfc463ec063cd29faea0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vast.ai#website\",\"name\":\"Vast.ai Documentation: Affordable GPU Cloud Marketplace\",\"url\":\"https://docs.vast.ai\",\"publisher\":{\"@id\":\"https://docs.vast.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vast.ai/host/vms#webpage\",\"url\":\"https://docs.vast.ai/host/vms\",\"name\":\"VMs\",\"dateModified\":\"2026-10-26T21:15:13.407Z\",\"isPartOf\":{\"@id\":\"https://docs.vast.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vast.ai/host/vms#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vast.ai/host/vms#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.vast.ai/host/optimization-guide\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"VMs\",\"item\":\"https://docs.vast.ai/host/vms\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.vast.ai/host/vms#article\",\"headline\":\"VMs\",\"name\":\"VMs\",\"url\":\"https://docs.vast.ai/host/vms\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vast.ai/host/vms#webpage\"},\"dateModified\":\"2026-10-26T21:15:13.407Z\",\"publisher\":{\"@id\":\"https://docs.vast.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vast.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vast.ai Documentation: Affordable GPU Cloud Marketplace\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Vast.ai Documentation: Affordable GPU Cloud Marketplace","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/get-started"}]},{"tab":"CLI \u0026 SDK","pages":[{"title":"CLI \u0026 SDK","href":"/cli/hello-world"}]},{"tab":"API","pages":[{"title":"API","href":"/api-reference/hello-world"}]},{"tab":"Host","groups":[{"group":"Concepts","icon":"lightbulb","pages":[{"title":"Hosting Overview","href":"/host/hosting-overview"},{"title":"Understanding Verification","href":"/host/understanding-verification"},{"title":"Earning","href":"/host/earning"}]},{"group":"Guides","icon":"warehouse","pages":[{"title":"Optimize Your Earnings","href":"/host/optimization-guide"},{"title":"Verification Stages","href":"/host/verification-stages"},{"title":"How to Self-Test","href":"/host/how-to-self-test"},{"title":"Using Your Own Machine","sidebarTitle":"Using Your Own Machine","href":"/host/using-your-own-machine"},{"title":"Host Notifications","sidebarTitle":"Notifications and Webhooks","href":"/host/notifications"},{"title":"Machine Metrics","sidebarTitle":"Machine Metrics","href":"/host/machine-metrics"},{"title":"GPU Market Metrics","sidebarTitle":"Market Metrics","href":"/host/market-metrics"},{"title":"Datacenter Status","href":"/host/datacenter-status"},{"title":"Host Payouts","href":"/host/payment"},{"title":"Tax Guide for Hosts","description":null,"href":"/host/guide-to-taxes"},{"title":"VMs","href":"/host/vms"},{"group":"Maintenance","pages":[{"title":"Set a Maintenance Window","description":"Schedule a maintenance window on one machine or on many at once from the Machines page, so renters are warned before you take hardware down.","href":"/host/set-maintenance-window"},{"title":"Upgrade the Kernel","href":"/host/upgrade-kernel"},{"title":"Upgrade the NVIDIA Driver","href":"/host/upgrade-nvidia-driver"},{"title":"Upgrade Docker and System Packages","sidebarTitle":"Upgrade Docker \u0026 Packages","href":"/host/upgrade-docker-and-packages"},{"title":"Disable SSH Password Login","href":"/host/disable-ssh-password-login"},{"title":"Check SSD Health","href":"/host/ssd-health"}]},{"group":"Troubleshooting","pages":[{"title":"Offline Machine - Troubleshooting Steps","sidebarTitle":"Offline Machine","href":"/host/machine-offline"}]}]},{"group":"CLI","icon":"terminal","pages":[{"title":"vastai cleanup machine","sidebarTitle":"cleanup machine","href":"/host/cli/cleanup-machine"},{"title":"vastai delete machine","sidebarTitle":"delete machine","href":"/host/cli/delete-machine"},{"title":"vastai list machine","sidebarTitle":"list machine","href":"/host/cli/list-machine"},{"title":"vastai list machines","sidebarTitle":"list machines","href":"/host/cli/list-machines"},{"title":"vastai show machine","sidebarTitle":"show machine","href":"/host/cli/show-machine"},{"title":"vastai show machines","sidebarTitle":"show machines","href":"/host/cli/show-machines"},{"title":"vastai set defjob","sidebarTitle":"set defjob","href":"/host/cli/set-defjob"},{"title":"vastai remove defjob","sidebarTitle":"remove defjob","href":"/host/cli/remove-defjob"},{"title":"vastai set min-bid","sidebarTitle":"set min-bid","href":"/host/cli/set-min-bid"},{"title":"vastai schedule maint","sidebarTitle":"schedule maint","href":"/host/cli/schedule-maint"},{"title":"vastai cancel maint","sidebarTitle":"cancel maint","href":"/host/cli/cancel-maint"},{"title":"vastai show maints","sidebarTitle":"show maints","href":"/host/cli/show-maints"},{"title":"vastai unlist machine","sidebarTitle":"unlist machine","href":"/host/cli/unlist-machine"},{"title":"vastai defrag machines","sidebarTitle":"defrag machines","href":"/host/cli/defrag-machines"},{"title":"vastai self-test machine","sidebarTitle":"self-test machine","href":"/host/cli/self-test-machine"},{"title":"vastai metrics gpu","sidebarTitle":"metrics gpu","href":"/host/cli/metrics-gpu"},{"title":"vastai metrics gpu-trends","sidebarTitle":"metrics gpu-trends","href":"/host/cli/metrics-gpu-trends"},{"title":"vastai metrics gpu-locations","sidebarTitle":"metrics gpu-locations","href":"/host/cli/metrics-gpu-locations"}]},{"group":"SDK","icon":"python","pages":[{"title":"VastAI.cleanup_machine","sidebarTitle":"cleanup_machine","href":"/host/sdk/cleanup-machine"},{"title":"VastAI.delete_machine","sidebarTitle":"delete_machine","href":"/host/sdk/delete-machine"},{"title":"VastAI.list_machine","sidebarTitle":"list_machine","href":"/host/sdk/list-machine"},{"title":"VastAI.list_machines","sidebarTitle":"list_machines","href":"/host/sdk/list-machines"},{"title":"VastAI.show_machine","sidebarTitle":"show_machine","href":"/host/sdk/show-machine"},{"title":"VastAI.show_machines","sidebarTitle":"show_machines","href":"/host/sdk/show-machines"},{"title":"VastAI.set_defjob","sidebarTitle":"set_defjob","href":"/host/sdk/set-defjob"},{"title":"VastAI.remove_defjob","sidebarTitle":"remove_defjob","href":"/host/sdk/remove-defjob"},{"title":"VastAI.set_min_bid","sidebarTitle":"set_min_bid","href":"/host/sdk/set-min-bid"},{"title":"VastAI.schedule_maint","sidebarTitle":"schedule_maint","href":"/host/sdk/schedule-maint"},{"title":"VastAI.cancel_maint","sidebarTitle":"cancel_maint","href":"/host/sdk/cancel-maint"},{"title":"VastAI.show_maints","sidebarTitle":"show_maints","href":"/host/sdk/show-maints"},{"title":"VastAI.unlist_machine","sidebarTitle":"unlist_machine","href":"/host/sdk/unlist-machine"},{"title":"VastAI.defrag_machines","sidebarTitle":"defrag_machines","href":"/host/sdk/defrag-machines"},{"title":"VastAI.self_test_machine","sidebarTitle":"self_test_machine","href":"/host/sdk/self-test-machine"}]}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/pytorch"}]}]},"title":"VMs - Vast.ai Documentation: Affordable GPU Cloud Marketplace","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":[],"chunks":[]}