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

FreeBSD Manual Pages

  
 
  

home | help
podman-machine-ssh(1)	    General Commands Manual	 podman-machine-ssh(1)

NAME
       podman-machine-ssh - SSH	into a virtual machine

SYNOPSIS
       podman machine ssh [options] [name] [command [arg ...]]

DESCRIPTION
       SSH into	a Podman-managed virtual machine and optionally	execute	a com-
       mand  on	the virtual machine. Unless using the default virtual machine,
       the first argument must be the virtual machine name. The	optional  com-
       mand to execute can then	follow.	If no command is provided, an interac-
       tive session with the virtual machine is	established.

       The  exit  code from ssh	command	is forwarded to	the podman machine ssh
       caller, see Exit	Codes <#Exit-Codes>.

       The default machine name	is podman-machine-default. If a	 machine  name
       is  not	specified  as an argument, then	podman-machine-default will be
       SSH'd into.

       Rootless	only.

OPTIONS
   --help
       Print usage statement.

   --username=name
       Username	to use when SSH-ing into the VM.

Exit Codes
       The exit	code from podman machine ssh gives information about  why  the
       command	failed.	 When podman machine ssh commands exit with a non-zero
       code, the exit codes follow the chroot standard,	see below:

       125 The error is	with podman itself

       $ podman	machine	ssh --foo; echo	$?
       Error: unknown flag: --foo
       125

       126 Executing a contained command and the command cannot	be invoked

       $ podman	machine	ssh /etc; echo $?
       Error: fork/exec	/etc: permission denied
       126

       127 Executing a contained command and the command cannot	be found

       $ podman	machine	ssh foo; echo $?
       Error: fork/exec	/usr/bin/bogus:	no such	file or	directory
       127

       Exit code contained command exit	code

       $ podman	machine	ssh /bin/sh -c 'exit 3'; echo $?
       3

EXAMPLES
       To get an interactive session with the default Podman machine:

       SSH into	the default Podman machine.

       $ podman	machine	ssh

       Run command inside the default Podman machine via ssh.

       $ podman	machine	ssh myvm

       Run command inside the specified	Podman machine via ssh.

       $ podman	machine	ssh myvm rpm -q	podman

SEE ALSO
       podman(1), podman-machine(1)

HISTORY
       March  2021,  Originally	 compiled  by	Ashley	 Cui   acui@redhat.com
       <mailto:acui@redhat.com>

							 podman-machine-ssh(1)

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

home | help