(:redirect Vmctl.Usage:)

# VMM User Guide

[VMM(4)](/https://man.openbsd.org/vmm) is a hypervisor, which allows us to run multiple virtual machines inside a single physical server (a dedicated server). Your virtual machine is a guest which lives inside the host.

## Connect to the Virtual Machine

Connect to the guest, username.coconut.ircnow.org.

# For Linux/Mac, open up a terminal and run `$ ssh username@username.coconut.ircnow.org` -- note that the hostname is username.coconut.ircnow.org and **not** coconut.ircnow.org.

# For Windows, you can use [PuTTY](/Shell/ShellPutty). For hostname, put `username@username.coconut.ircnow.org` -- note that the hostname is username.coconut.ircnow.org and **not** coconut.ircnow.org.

## Manage the Virtual Machine

Connect to the host, which runs the hypervisor. For IRCNow, this host is coconut.ircnow.org.

# For Linux/Mac, open up a terminal and run `$ ssh username@coconut.ircnow.org` -- note that the hostname is coconut.ircnow.org and **not** username.coconut.ircnow.org.

# For Windows, you can use [PuTTY](/Shell/ShellPutty). For hostname, put `username@coconut.ircnow.org` -- note that the hostname is coconut.ircnow.org and **not** username.coconut.ircnow.org.

**NOTE**: The host is **not** your personal VM. Your personal VM is a guest inside the host, and will have the name username.coconut.ircnow.org, not coconut.ircnow.org. The guest lives inside the host, so in order to create the guest, you must first log in to the host.

Attach:vmminstall-1.png

Once inside the host (coconut.ircnow.org), you can control your virtual machine using the following commands. <vm-name> is most likely your username.

# To view the [serial console](https://man.openbsd.org/cu) to [[install, upgrade, or repair](/openbsd/vmminstall) the system:
# To view the [serial console](https://man.openbsd.org/cu) to [[install, upgrade, or repair](/openbsd/vmminstall) the system:

    $ vmctl console <vm-name>


To shutdown the VM:

    $ vmctl stop <vm-name>


To boot the VM:

    $ vmctl start <vm-name>


To pause the VM:

    $ vmctl pause <vm-name>


To unpause the VM:

    $ vmctl unpause <vm-name>


At any time, if you want to escape the serial console, type `~.` (tilde followed by a period) or `~^d` (tilde followed by ctrl+d). **Note**: ^d is ctrl+d. Sometimes, you may need to press enter a few times before the `~.` or `~^d` combination works. On some keyboards, you may need to type `~~.` (two tildes followed by a period).

## Install, Upgrade, Repair

If you need to upgrade, install, or repair OpenBSD, you will also want to check out the [VMM Install Guide](/Openbsd/vmminstall).

## See Also

|| [vmctl(8)](https://man.openbsd.org/vmctl) || [[VMM Install Guide](/openbsd/vmminstall) ||
|| [vmctl(8)](https://man.openbsd.org/vmctl) || [[VMM Install Guide](/openbsd/vmminstall) ||