Terminals and Sessions

One window

MicroVMs open in the main window, never in windows of their own. Select a MicroVM in the sidebar to see its terminal. The others keep their sessions out of sight, screen and scrollback included. The header shows the MicroVM's state and time left, and its buttons: Suspend or Resume, Terminate…, Disconnect, History, Upload… and Download…. In a narrow window the last three are in a More menu. The MicroVM menu has them all.

Setup

Each time a workspace's MicroVM connects, the pane ticks off its setup: mounting /workspace with persistent storage, copying files, adding credentials, cloning repos and running setup commands. Cancel stops setup at any step and closes the connection. The pane then offers Close, Open Shell Anyway and Try Again. Escape doesn't cancel, so a key meant for the terminal can't stop setup. When a step fails, see Troubleshooting.

Keep session (tmux)

Keep the session when you disconnect (tmux), in the workspace's Behaviour section, is on for new workspaces. Reconnecting returns to the same tmux session, with everything still running in it, and a dropped connection reconnects by itself: it tries 8 times over about two minutes, and Reconnect Now skips the wait. The image needs tmux; the starter image has it. Plain shells in Other MicroVMs, and Open Shell Anyway, don't keep their shell.

Splits

⌘W

While a terminal is shown, ⌘W is Disconnect. When every pane keeps its shell in tmux, it disconnects without asking; otherwise it asks first, because the shells end and anything running in them stops. With no terminal shown, ⌘W closes the window. Neither terminates the MicroVM: it keeps running, and billing. Closing the window and quitting ask in the same way. In these questions Return and Escape both cancel.

Disconnect and reconnect

Disconnect, in the header or the MicroVM menu, does what ⌘W does: it closes the terminal and leaves the MicroVM running. It doesn't reconnect by itself: press Connect. When a shell exits or the connection drops, the pane says so, and Reconnect connects again: with Keep session you're back in the same tmux session, and without it you get a new shell.

After the Mac wakes, MicroVM Studio checks each connection straight away, so a dead one shows up quickly. With Keep session, a dropped connection also reconnects as soon as the network comes back.

Idle and suspend

Three settings in the workspace's Time limits section decide what happens while no terminal is connected. Idle means just that: work running inside the MicroVM doesn't count.

The last two apply only while Suspend when idle is on. Workspaces saved before these settings keep what they did: Keep working when detached on became Suspend when idle Off, and off became 5 minutes.

History

History in the header shows what happened to the MicroVM, newest first, each with its time: its launch by MicroVM Studio, running, suspended, resumed and terminated, and terminals connecting and disconnecting. MicroVM Studio records it while it's open, and sees state changes within about a minute. A MicroVM's history is kept for 7 days after it stops.