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 pro-
       vides the  ability  to  control	the  lifecycle	of  existing  machines
       (bootup/shutdown,pause/resume,suspend/restore),	provision  new virtual
       machines	and various types of store, manage  virtual  networks,	access
       the graphical console of	virtual	machines, and view performance statis-
       tics, 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-MAN-
	      AGER, SSH, AND FORKING section for more info.

       --fork Force forking virt-manager off into the background.  This	is the
	      default  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
       disabled. 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 ma-
	      chine  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	speci-
       fying 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
       terminal	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 envi-
       ronment 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 re-
       leased in October 1st 2024.

       virt-manager no longer forks by defaults.

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

       However if you find you need forking for	a usecase other	than temporar-
       ily working around libvirt version issues, please let the  virt-manager
       developers 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
       software. 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 WARRANTY, to the extent permitted by law.

SEE ALSO
       virsh(1),   virt-viewer(1),  the	 project  website   <https://virt-man-
       ager.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.0>

home | help