PUTER-SSH(1) Puter Manual PUTER-SSH(1)

puter-ssh - SSH into a VM

puter ssh [options] name [-- ssh-args...]

Open an SSH connection to a running VM. Uses the VM's assigned IP address and connects via the host's SSH client. Additional arguments after -- are passed directly to ssh(1).

SSH username. Overrides the VM's configured default user. If not specified, uses the user configured at VM creation time (auto-detected from the OCI image's USER directive, or "root" if the image has no USER set).

SSH with the VM's default user:

$ puter ssh myvm
ubuntu@myvm:~$

SSH as a different user:

$ puter ssh -u ubuntu myvm

Pass extra arguments to ssh:

$ puter ssh myvm -- -L 8080:localhost:80

puter-ssh-key(1), puter-console(1), puter-start(1)

2026-03-02 puter