Power State Virtual Machine Manager

v1.0.0

Set the power state of a QEMU/KVM Virtual Machine (VM). Wake from Sleep or Hibernation. Does what virt-manager doesn't.

Download

View this repository on Codeberg or GitHub.

Table of Contents

• 1. Why?
• 2. Related Projects
• 3. Documentation
• 4. Host Requirements
  • 4.1. Operating System
  • 4.2. Software
  • 4.3. Hardware
• 5. Download
• 6. Usage
  • 6.1. Install
  • 6.2. Run
• 7. Contact
• 8. References

Contents

1. Why?

The virtual machine manager application virt-manager does not (currently) have the option to wake a VM from Sleep. In other words, as a VM cannot be awaken by an input device, unfortunately. For example, a physical or virtual "power on", button, keyboard input, or network activity. This application includes the ability to wake from Sleep and Hibernation, and the other related features from virt-manager.

2. Related Projects

To view other relevant projects, visit Codeberg or GitHub.

3. Documentation

• What is VFIO?^[2]
• VFIO Discussion and Support^[3]
• Hardware-Passthrough Guide^[1]
• Virtual Machine XML Format Guide^[4]

4. Host Requirements

4.1. Operating System

Linux.

4.2. Software

• QEMU and Libvirt for Virtual Machines.

4.3. Hardware

The following firmware options are supported and enabled (motherboard and CPU):

• System Power State S3 (Sleep).
• System Power State S4 (Hibernation).

5. Download

• Download the Latest Release: Codeberg or GitHub

• Download the .zip file:

  1. Viewing from the top of the repository's (current) webpage, click the drop-down icon:
     • ··· on Codeberg.
     • <> Code on GitHub.
  2. Click Download ZIP and save.
  3. Open the .zip file, then extract its contents.

• Clone the repository:

  1. Open a Command Line Interface (CLI) or Terminal.
     • Open a console emulator (for Debian systems: Konsole).
     • Linux only: Open an existing console: press CTRL + ALT + F2, F3, F4, F5, or F6.
       • To return to the desktop, press CTRL + ALT + F7.
       • F1 is reserved for debug output of the Linux kernel.
       • F7 is reserved for video output of the desktop environment.
       • F8 and above are unused.
  2. Change your directory to your home folder or anywhere safe:
     • cd ~
  3. Clone the repository:
     • git clone https://www.codeberg.org/portellam/powerstate-virtmanager
     • git clone https://www.github.com/portellam/powerstate-virtmanager

6. Usage

6.1. Install

sudo bash installer.sh

6.2. Run

Installer will copy required files to /usr/bin/local/. You may run executable from any directory.

sudo powerstate-virtmanager

7. Contact

Do you need help? Please visit the Issues page.

8. References

1.

  PCI passthrough via OVMF. ArchWiki. Accessed June 14, 2024.

    ^{https://wiki.archlinux.org/title/PCI_passthrough_via_OVMF.}

2.

  VFIO - ‘Virtual Function I/O’ - The Linux Kernel Documentation. The linux kernel. Accessed June 14, 2024.

    ^{https://www.kernel.org/doc/html/latest/driver-api/vfio.html.}

3.

  VFIO Discussion and Support. Reddit. Accessed June 14, 2024.

    ^{https://www.reddit.com/r/VFIO/.}

Click here to return to the top of this document.