> For the complete documentation index, see [llms.txt](https://docs.vergeos-demo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vergeos-demo.com/run-the-platform/virtual-machines/working-with-vms.md). # Working With Virtual Machines (VMs) ## VM Console Access The [Remote Console](/run-the-platform/virtual-machines/vm-remote-console.md) provides video/keyboard-mouse access to your VMs through the VergeOS user interface. * **Open a single VM Remote Console**: Navigate to the VM dashboard and click Remote Console on the left nav menu. * **Open Remote Console for multiple VMs (in separate tabs)**: Select VMs in the Virtual Machines listing, click Remote Console on the left nav menu. (This can be blocked by some pop-up blockers.) ## Clone a VM The cloning feature allows you to create a new VM instance as a replica of an existing VM (with or without same MAC addresses). This can come in handy for a variety of uses: testing, deployment, data recovery, etc. Cloning a VM in VergeOS is nearly instantaneous and an easy process. {% hint style="success" %} While cloning allows you to make a simple copy of a VM, [Recipes](/automate-protect-and-extend/automation/vm-recipes.md) empower you to generate new custom VM instances based on a template VM; recipe questions provide for adjusting details per instance, as it is created, such as IP address, guest username/passwords, allocated resources, networks, etc. {% endhint %} ### Cloning Steps 1. When possible, **stop the VM** before cloning it. 2. From the **VM Dashboard or on the Virtual Machines listing** page with a VM selected, select **Clone** from the left menu.\ The name of the source VM along with the resources (cores/RAM, OS, # of drives, and # of NICs) is displayed. 3. The **VM Name** will default to original VM Name + "clone"; the name can be changed as desired. 4. By default, a new unique MAC address (different from the source VM) is created for each NIC device in the new instance. The "Preserve MAC Addresses" option can be enabled to copy MAC addresses from the original VM to the new clone instance. 5. Click **Submit**. The VM instance is created and the new VM's dashboard page appears. {% hint style="warning" %} The Preserve MAC address setting should be used with caution to avoid duplicate addresses running on the same network, which will cause problems. {% endhint %} ## Delete a VM Considerations when deleting a VM: * The VM must be powered down before it can be deleted. * The system will not allow a VM to be deleted if it is running. * A VM that is currently the basis of a VM Recipe cannot be deleted. * Deleting a VM will also delete its VM snapshots; however, the VM will still be included in System Snapshots that were taken while the VM existed. ## Power off / Restart / Reset / Kill power It's important to understand the different behaviors of the *Power off / Restart / Hard Reset / Kill power* commands for VMs. * **Power off** - issues an ACPI command to the VM, and relies on ACPI being enabled/configured within the guest OS. Power off initiates a graceful shutdown of the VM. * **Restart** - initiates a graceful shutdown and then power on of the VM. An ACPI command is issued to the VM, and relies on ACPI being enabled/configured within the guest OS. {% hint style="success" %} **Before putting a server into production, it is recommended to test a *****Power Off***** and *****Restart***** operation from the VergeOS user interface, both while a user is logged into the guest OS and when no user is logged in/screen is locked.** {% endhint %} * **Hard Reset** - This option should only be used when it is not possible to access the guest OS for a graceful shutdown (e.g. the guest OS crashed or locked). This powers off hardware, without attempting a graceful shutdown of the guest OS, and powers on again. * **Kill Power** - This option should only be used when it is not possible to access the guest OS for graceful shutdown (e.g. the guest OS crashed or locked). This would be equivalent to pulling the power plug on a bare metal machine. --- # 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: ``` GET https://docs.vergeos-demo.com/run-the-platform/virtual-machines/working-with-vms.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.