podman-machine-ssh

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 command on the virtual machine. Unless using the default virtual machine, the first argument must be the virtual ma
   chine name. The optional command to execute can then follow. If no command is provided, an interactive 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)