> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/virtual-machines.md).

# Virtual machines

- [Creating Virtual Machines (VMs)](https://docs.verge.io/run-the-platform/virtual-machines/creating-vms.md): Guide to creating virtual machines in VergeOS, including custom VMs, recipe-based deployments, imports, and cloning existing VMs.
- [VergeOS Guest OS Compatibility](https://docs.verge.io/run-the-platform/virtual-machines/guest-os-compatibility.md): Reference guide for supported guest operating systems on VergeOS, including Windows, Linux, and FreeBSD versions with recommended interfaces and minimum requirements.
- [Importing VMs from a NAS Volume](https://docs.verge.io/run-the-platform/virtual-machines/import-from-nas.md): Instructions for bulk importing virtual machines from NFS or CIFS network shares into VergeOS using the NAS volume import method.
- [Importing VMs from Uploaded Media Images](https://docs.verge.io/run-the-platform/virtual-machines/import-from-upload.md): Guide to importing virtual machines by uploading disk image and configuration files (VMX, VMDK, OVF, VHD, QCOW) to the vSAN for individual VM import.
- [Importing VMs from VMware Service Backup Jobs](https://docs.verge.io/run-the-platform/virtual-machines/import-from-vmware.md): Guide to importing VMware virtual machines into VergeOS using the VMware service backup connector with incremental backup and minimal downtime migration.
- [Live Migrations](https://docs.verge.io/run-the-platform/virtual-machines/live-migrations.md): Guide to performing live migrations of running VMs between nodes and virtual disks between storage tiers in VergeOS without service interruption.
- [Virtual Machine Management (VergeHV)](https://docs.verge.io/run-the-platform/virtual-machines/overview.md): Overview of VergeOS virtual machine management capabilities powered by the VergeHV hypervisor, covering enterprise-grade compute, storage, networking, and automation features.
- [Sharing Disks Between Virtual Machines](https://docs.verge.io/run-the-platform/virtual-machines/sharing-disks-between-vms.md): Overview of the supported methods for sharing disks and data between virtual machines in VergeOS, including Clone Disk and NAS-based file sharing, with guidance on when to use each.
- [VDI Administrator Instructions](https://docs.verge.io/run-the-platform/virtual-machines/vdi-administrator.md): Administrator guide for configuring VDI user access, assigning VM console permissions, managing VM favorites, and setting VM ownership in VergeOS.
- [Virtual Desktop Infrastructure (VDI)](https://docs.verge.io/run-the-platform/virtual-machines/vdi-overview.md): Overview of VergeOS VDI functionality for hosting virtual desktops with individualized user dashboards for desktop access.
- [VDI User Instructions](https://docs.verge.io/run-the-platform/virtual-machines/vdi-user.md): End-user guide for accessing virtual desktops via the VDI dashboard, using the VM console, changing passwords, and managing two-factor authentication.
- [Viewing Import Jobs](https://docs.verge.io/run-the-platform/virtual-machines/view-import-jobs.md): Instructions for viewing and monitoring VM import job status, child jobs, and imported VM listings in VergeOS.
- [Virtual Machine Best Practices](https://docs.verge.io/run-the-platform/virtual-machines/vm-best-practices.md): Comprehensive best practices for VergeOS virtual machines covering RAM allocation, CPU selection, networking, storage, security, guest OS configuration, and data protection.
- [Virtual Machine Drives](https://docs.verge.io/run-the-platform/virtual-machines/vm-drives.md): Guide to adding, modifying, erasing, and removing virtual machine drives in VergeOS, including disk types, interfaces, media options, and storage tier selection.
- [VM Export Volume](https://docs.verge.io/run-the-platform/virtual-machines/vm-export-volume.md): Overview of the VergeOS NAS VM Export volume type for creating exportable VM snapshots accessible to external systems and third-party backup software.
- [Virtual Machine Fields](https://docs.verge.io/run-the-platform/virtual-machines/vm-field-descriptions.md): Complete reference for all VergeOS virtual machine configuration fields including name, RAM, CPU, boot order, machine type, console type, UEFI, and power settings.
- [VM Guest Agent](https://docs.verge.io/run-the-platform/virtual-machines/vm-guest-agent.md): Guide to enabling and installing the QEMU guest agent on VergeOS VMs for consistent snapshots, graceful shutdown, and enhanced host-guest communication.
- [Manual VM Migration](https://docs.verge.io/run-the-platform/virtual-machines/vm-manual-migration.md): Instructions for manually migrating running VMs between host nodes in VergeOS, including single VM and bulk migration procedures.
- [Migrating Workloads into VergeOS](https://docs.verge.io/run-the-platform/virtual-machines/vm-migration-overview.md): Comprehensive overview of VM migration methods for importing workloads into VergeOS from VMware, Hyper-V, KVM, and physical servers, including planning guidance and supported file formats.
- [Virtual Machine Network Interfaces (NICs)](https://docs.verge.io/run-the-platform/virtual-machines/vm-nics.md): Guide to adding, modifying, deleting, and disabling virtual network interfaces on VergeOS VMs, including interface types, MAC address management, and network assignment.
- [Using the Virtual Machine Remote Console](https://docs.verge.io/run-the-platform/virtual-machines/vm-remote-console.md): Guide to using the VergeOS VM remote console for direct keyboard and mouse interaction, including toolbar features, clipboard, power controls, and extra keys.
- [Working With Virtual Machines (VMs)](https://docs.verge.io/run-the-platform/virtual-machines/working-with-vms.md): Day-to-day VM management operations in VergeOS including console access, cloning, deleting, and power operations like restart, reset, and kill.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/virtual-machines.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
