Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
VIRT-MANAGER(1) 	     Virtualization Support		 VIRT-MANAGER(1)

NAME
     virt-manager - Graphical tool for managing libvirt VMs

SYNOPSIS
     virt-manager [OPTIONS]

DESCRIPTION
     virt-manager  is  a desktop tool for managing virtual machines. It provides
     the ability to control the lifecycle  of  existing  machines  (bootup/shut-
     down,pause/resume,suspend/restore), provision new virtual machines and var-
     ious  types of store, manage virtual networks, access the graphical console
     of virtual machines, and view performance statistics, all done  locally  or
     remotely.

OPTIONS
     Standard GTK options like --g-fatal-warnings are accepted.

     The following options are accepted when running virt-manager

     -h, --help
	    Display command line help summary

     --version
	    Show virt-manager's version number and exit

     -c, --connect
	    Specify the hypervisor connection URI

     --debug
	    List  debugging  output to the console (normally this is only logged
	    in ~/.cache/virt-manager/virt-manager.log).  This  function  implies
	    --no-fork.

     --no-fork
	    Don't  fork virt-manager off into the background.  See VIRT-MANAGER,
	    SSH, AND FORKING section for more info.

     --fork
	    Force forking virt-manager off into the background.  This is the de-
	    fault behavior.  See VIRT-MANAGER, SSH, AND FORKING section for more
	    info.

DIALOG WINDOW OPTIONS
     For these options, only the requested window will	be  shown,  the  manager
     window will not be run in this case. Connection autostart will also be dis-
     abled. All these options require specifying a manual --connect URI.

     --show-domain-creator
	    Display the wizard for creating new virtual machines

     --show-domain-editor NAME|ID|UUID
	    Display  the  dialog  for  editing properties of the virtual machine
	    with unique ID matching either the domain name, ID, or UUID

     --show-domain-performance NAME|ID|UUID
	    Display the dialog for monitoring performance of the virtual machine
	    with unique ID matching either the domain name, ID, or UUID

     --show-domain-console NAME|ID|UUID
	    Display the virtual console of the virtual machine	with  unique  ID
	    matching either the domain name, ID, or UUID

     --show-host-summary
	    Display the host/connection details window.

SYSTEM TRAY OPTION
     Connection autostart will not be disabled and thus don't require specifying
     a manual --connect URI. But it supports --connect URI as well:

     --show-systray
	    Launch virt-manager only in system tray

VIRT-MANAGER, SSH, AND FORKING
     Historically,  on startup virt-manager would detach from the running termi-
     nal and fork into the background. This was to force any  usage  of  ssh  to
     call  ssh-askpass when it needed a password, rather than silently asking on
     a terminal the user probably isn't watching.

     openssh 8.4p1 released in Sep 2020 added the  SSH_ASKPASS_REQUIRE	environ-
     ment variable that saves us from having to do the fork dance.
      <https://man.openbsd.org/ssh.1#SSH_ASKPASS_REQUIRE>

     virt-manager  now	sets  SSH_ASKPASS_REQUIRE=force.  However to get this to
     work with libvirt ssh connections, you'll need libvirt 10.8.0  released  in
     October 1st 2024.

     virt-manager no longer forks by defaults.

     You  can get the old forking behavior with the --fork option, or by setting
     the VIRT_MANAGER_DEFAULT_FORK=yes environment variable.

     However if you find you need forking for a usecase other  than  temporarily
     working around libvirt version issues, please let the virt-manager develop-
     ers know by filing a bug report.

BUGS
     Please see  <https://virt-manager.org/bugs/>

COPYRIGHT
     Copyright	(C)  Red Hat, Inc, and various contributors.  This is free soft-
     ware. You may redistribute copies of it under the terms of the GNU  General
     Public  License  <https://www.gnu.org/licenses/gpl.html> . There is NO WAR-
     RANTY, to the extent permitted by law.

SEE ALSO
     virsh(1), virt-viewer(1), the project website  <https://virt-manager.org>

								 VIRT-MANAGER(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=virt-manager&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help