Machines and lifecycle

A machine is either a sandbox (code and headless work) or a computer (a full GUI desktop). Lifecycle commands work on both.

Create a sandbox

miosa create [name] [flags]

miosa create my-box --wait
miosa create ci-box --size small --template miosa-sandbox --ttl 2h --wait
miosa create my-box --env staging --setup-file ./setup.sh

List and inspect

miosa list --state running
miosa list --json | jq -r '.data[].name'
miosa info my-box            # state, environment and setup status
miosa usage my-box           # runtime, time left and estimated cost

miosa list takes --state, --tag, --template, --search, --workspace, --workspace-id, --limit, --page, --ids (print only ids) and --errored (include sandboxes in the error state).

miosa info shows the pinned environment version (for example staging v1) and whether an upgrade is available.

Current sandbox

miosa use my-box     # set the current sandbox
miosa use            # show it
miosa exec -- npm test

Anywhere a sandbox is expected you may give its name, its id, current or self (inside a sandbox).

Start, stop, pause, resume, restart

miosa stop my-box     # keep the disk
miosa pause my-box    # keep disk and memory state
miosa resume my-box
miosa restart my-box --wait   # power-cycle in place: same id, same disk

miosa restart stops the sandbox keeping its disk and boots that disk again, so files, packages and enabled services survive and running processes start fresh. Use it when a sandbox stops answering. If its host stopped it with a memory checkpoint instead, the sandbox comes back from memory and the command says so, with the next step.

Extend, tag and wait

miosa extend my-box --for 2h    # replace the time to live
miosa tag my-box --set team=ci
miosa wait my-box --for running

miosa extend --for accepts seconds, 90m, 2h or 2d, and replaces the old value rather than adding to it.

Fork and recover

miosa fork my-box copy-box      # a running copy of a sandbox
miosa recover my-box            # recover the disk into a NEW sandbox

Destroy

miosa destroy my-box --yes
miosa destroy my-box other-box

--yes is required when there is no terminal. Destroy is permanent.

Computers

Computers are the GUI machines. Every command that acts on one takes --computer where a machine argument appears.