Getting Started

MicroVM Studio starts AWS Lambda MicroVMs from workspaces you set up, and gives each one a terminal on your Mac.

What you need

Setting up

Until you save a workspace, the main window shows Get started: a short checklist. Each line is ticked once it's done, says what it's set to, and has a button that opens Settings on the right tab. Do them in any order, and come back to any of them later in Settings. Once a workspace is saved, the checklist is gone for good.

Optional, in Settings

The starter image

The starter image has git, tmux, gh, the AWS CLI, Node 22, Claude Code and Codex, and a user called dev. It's built once in your AWS account and takes about 5 minutes. Its size is 1 vCPU · 2 GB unless you choose another; see Images. Before you press Build, the sheet lists what it makes in AWS: an S3 bucket for the recipe, an IAM role for the build, and the image. Closing the sheet doesn't stop the build. Build or update it later in Settings → Images.

Any of your images in the region can be the default instead: the starter image is simply the quickest way to start.

Your first workspace

A workspace is a saved recipe for a MicroVM. Press + next to Workspaces in the main window, give it a name, check the profile, region and image, and choose Save: Quick start needs nothing more. Then press Launch on it: the MicroVM starts, setup runs, and the terminal connects.

Everything else is in Settings. General has the profile's regions, what new workspaces start with, the permission check and the guardrails; Network Connectors, Images and Storage have the profile's connectors, images and file systems. GitHub, Secrets and Terminal are the same for every profile.