NAME

ash-attach - attach to a running VM

DESCRIPTION

Attaches to a running ash VM over SSH using the VM's vsock CID from virtle status. With --serial, connects to the persistent serial socket created by --kernel-serial=socket instead.

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.

SERIAL ATTACH

Pass --serial to attach through serial.sock instead of SSH. The VM must already be running and have been spawned with --kernel-serial=socket. Press Ctrl-] to disconnect.

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 --serial 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.