podman-machine-ssh(1)

💖 podman-machine-ssh(1) — bestie edition 💖

okay so we're doing the podman-machine-ssh page from the General Commands Manual and honestly? it's giving "let me just pop into my VM real quick" energy ✨

---

🌸 NAME 🌸

podman-machine-ssh — SSH into a virtual machine 🖥️✨

---

🦋 SYNOPSIS 🦋

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

---

💅 DESCRIPTION 💅

So here's the tea, bestie: podman machine ssh SSHes you into a Podman-managed virtual machine, and if you want, it'll also run a command for you while it's in there. no cap 🫶

Unless you're using the default virtual machine, the first argument has to be the virtual machine name. After that name, the optional command you wanna execute can follow. And if you don't hand it a command at all? You get a whole interactive session with the VM, main character style 👑

The exit code from the ssh command gets forwarded right back to the podman machine ssh caller — check Exit Codes ⟨#Exit-Codes⟩ for the deets.

The default machine name is podman-machine-default. So if you don't specify a machine name as an argument, then podman-machine-default is what you'll be SSH'd into. it's literally the default, that's the whole vibe 💫

Rootless only. that's it, that's the note. 🍓

---

✨ OPTIONS ✨

• --help — prints the usage statement. classic. iconic. we love a helper 🎀
• --username=name — the username to use when SSH-ing into the VM 🙈

---

🔥 Exit Codes 🔥

The exit code from podman machine ssh tells you why the command failed — like a little vibe check for your errors. 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 — whatever the command inside felt like returning, you get it back fr fr 🌈

$ 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⟩

---

and that's the whole page, bestie!! mwah 💋 this was podman-machine-ssh(1) from the General Commands Manual — go forth and SSH into ur VM like the icon u are 🦋✨💖