// Module included in the following assemblies:
//
// * virt/virtual_machines/virt-controlling-vm-states.adoc

:_mod-docs-content-type: PROCEDURE
[id="virt-restarting-vm-web_{context}"]
= Restarting a virtual machine

[role="_abstract"]
You can restart a running virtual machine (VM) from the web console.

[IMPORTANT]
====
The *Restart* action shuts down the VM and starts a new pod. This action removes all related resources including the `virt-launcher` pod and recreates them.

To avoid errors, do not restart a VM while it has a status of *Importing*.
====

.Procedure

. Click *Virtualization* -> *VirtualMachines* from the side menu.

. In the tree view, select the project that contains the VM that you want to restart.

. Navigate to the appropriate menu for your use case:

* To stay on this page, where you can perform actions on multiple VMs:

.. Click the Options menu {kebab} located at the far right end of the row and click *Control* -> *Restart*.
.. If action confirmation is enabled, click *Restart* in the confirmation dialog.

* To restart the VM from the tree view:

.. Click the *>* icon next to the project name to open the list of VMs.

.. Right-click the name of the VM and select *Control* -> *Restart*.
.. If action confirmation is enabled, click *Restart* in the confirmation dialog.

* To view comprehensive information about the selected VM before
you restart it:

.. Access the *VirtualMachine details* page by clicking the name of the virtual
machine.

.. Click *Actions* -> *Restart*.
.. If action confirmation is enabled, click *Restart* in the confirmation dialog.
