NAME

ash-attach - ssh into a running VM

DESCRIPTION

Attaches to a running ash VM over SSH using the VM's vsock CID from virtle status.

VM SELECTION

Pass NAME to attach to that VM. If NAME is omitted, attach requires exactly one running VM.

SPAWNING STOPPED VMS

With --spawn, attach can start a stopped named VM from saved ash-state.toml, regenerate virtle.toml, then attach.

--spawn starts a foreground VM that stops when SSH exits. Add --keep to start it as a background systemd user unit and keep it running after SSH exits.

SSH AUTOPROVISIONING

Attach creates or reuses id_ed25519 in the VM state directory, installs the public key through virtle guest-exec, and passes that identity to ssh.

Pass --kitty to use kitten ssh instead of ssh for this attached session. The current config's global.kitty setting also provides the default for the VM.

Pass --waypipe to forward guest Wayland and X11 applications to the host compositor. Waypipe uses Ash's generated SSH wrapper, enables xwayland-satellite for X11 clients, and can use the Kitty wrapper when --kitty is also passed.

EXAMPLES

ash attach work

ash attach --waypipe work

ash attach --waypipe --kitty work

ash attach --spawn work

ash attach --spawn --keep work

Generated from ash Cmdliner manpage metadata.