---
description: Run Flue sandbox work in a local libkrun-backed virtual machine.
---

# smolvm

Last updated May 30, 2026 [ View as Markdown](https://flueframework.com/docs/ecosystem/sandboxes/smolvm/index.md) 

The smolvm connector adapts an initialized `Machine` from `smolvm-embedded` into Flue’s sandbox interface. Unlike a hosted sandbox service, smolvm runs locally through a host hypervisor.

## Add the connector

```
pnpm exec flue add smolvm
```

## Requirements

| Requirement          | Value                                                    |
| -------------------- | -------------------------------------------------------- |
| Provider package     | smolvm-embedded                                          |
| Supported host shape | macOS or Linux host with suitable virtualization support |
| Credential           | None required by smolvm itself                           |
| Unsupported runtime  | Edge/Worker runtimes without local hypervisor execution  |

## Choose this connector when

Use smolvm for trusted desktop, CI, or server environments where local microVM execution is the desired isolation boundary. The host running the Flue application must support the underlying virtualization mechanism; this is not a Cloudflare Worker sandbox option.

The connector recipe treats networking and machine lifetime as explicit choices. Do not assume a local VM has network access or that it will be cleaned up without your application doing so.

See [Deploy on Node.js](https://flueframework.com/docs/ecosystem/deploy/node/), [Sandboxes](https://flueframework.com/docs/guide/sandboxes/), and [Sandbox Connector API](https://github.com/withastro/flue/blob/main/docs/sandbox-connector-spec.md).

## Docs Navigation

Current page: [smolvm](https://flueframework.com/docs/ecosystem/sandboxes/smolvm/)

### Sections

* [Guide](https://flueframework.com/docs/getting-started/quickstart/)
* [Reference](https://flueframework.com/docs/api/agent-api/)
* [CLI](https://flueframework.com/docs/cli/overview/)
* [SDK](https://flueframework.com/docs/sdk/overview/)
* [Ecosystem](https://flueframework.com/docs/ecosystem/overview/)

### Ecosystem

* [ Overview ](https://flueframework.com/docs/ecosystem/overview/)

### Deployment

* [ Cloudflare ](https://flueframework.com/docs/ecosystem/deploy/cloudflare/)
* [ GitHub Actions ](https://flueframework.com/docs/ecosystem/deploy/github-actions/)
* [ GitLab CI/CD ](https://flueframework.com/docs/ecosystem/deploy/gitlab-ci/)
* [ Node.js ](https://flueframework.com/docs/ecosystem/deploy/node/)
* [ Render ](https://flueframework.com/docs/ecosystem/deploy/render/)

### Sandboxes

* [ boxd ](https://flueframework.com/docs/ecosystem/sandboxes/boxd/)
* [ Cloudflare Shell ](https://flueframework.com/docs/ecosystem/sandboxes/cloudflare-shell/)
* [ Cloudflare Sandbox ](https://flueframework.com/docs/ecosystem/sandboxes/cloudflare/)
* [ Daytona ](https://flueframework.com/docs/ecosystem/sandboxes/daytona/)
* [ E2B ](https://flueframework.com/docs/ecosystem/sandboxes/e2b/)
* [ exe.dev ](https://flueframework.com/docs/ecosystem/sandboxes/exedev/)
* [ islo ](https://flueframework.com/docs/ecosystem/sandboxes/islo/)
* [ Mirage ](https://flueframework.com/docs/ecosystem/sandboxes/mirage/)
* [ Modal ](https://flueframework.com/docs/ecosystem/sandboxes/modal/)
* [ smolvm ](https://flueframework.com/docs/ecosystem/sandboxes/smolvm/)
* [ Superserve ](https://flueframework.com/docs/ecosystem/sandboxes/superserve/)
* [ Vercel Sandbox ](https://flueframework.com/docs/ecosystem/sandboxes/vercel/)