ix shell
Open a shell in a VM.
An interactive process inside the guest. For output that already happened, use ix logs.
Resumes your most recently detached shell session when one is free (sessions survive disconnects), and creates one otherwise; a session another client holds is never taken over. Pass --new to always start fresh.
Interactive by default; when stdout is not a TTY or with --noninteractive, the given command is streamed instead.
ix shell [OPTIONS] <VM> [COMMAND]...Arguments
| Argument | Description |
|---|---|
<VM> | VM name from ix ls |
<COMMAND> | Command to run instead of the default shell. Runs in an interactive terminal by default (e.g. ix shell vm -- sh); pass --noninteractive for a one-off streamed command like ix shell vm --noninteractive -- uname -a |
Options
| Flag | Description |
|---|---|
-l, --list | List this VM's open console sessions and exit, instead of opening one. Use this to see what is running before picking a session with --attach |
-a, --attach <SESSION_ID> | Attach to an existing console session by id (from --list), taking it over from any client currently holding it. Plain ix shell only resumes sessions nobody holds; targeting an exact or held session is this explicit choice |
--new | Start a fresh session instead of resuming the most recently detached one |
--noninteractive | Run the command without a terminal: stream its stdout/stderr and exit with its status, instead of opening an interactive PTY. Has no stdin. Requires a command, e.g. ix shell vm --noninteractive -- uname -a |