# SmolVM

## Docs

- [Technical Architecture](https://mintlify.wiki/CelestoAI/SmolVM/advanced/architecture.md): Deep dive into SmolVM's architecture, components, and design decisions
- [Performance Benchmarks](https://mintlify.wiki/CelestoAI/SmolVM/advanced/performance.md): Performance characteristics, optimization tips, and benchmark results for SmolVM
- [Troubleshooting Guide](https://mintlify.wiki/CelestoAI/SmolVM/advanced/troubleshooting.md): Common issues, error messages, and solutions for SmolVM
- [CommandResult](https://mintlify.wiki/CelestoAI/SmolVM/api/commandresult.md): Result object returned from executing commands on a guest VM via SSH
- [Exceptions](https://mintlify.wiki/CelestoAI/SmolVM/api/exceptions.md): Exception classes for error handling in SmolVM
- [HostManager](https://mintlify.wiki/CelestoAI/SmolVM/api/hostmanager.md): Validates host environment and manages the Firecracker binary for SmolVM.
- [ImageBuilder](https://mintlify.wiki/CelestoAI/SmolVM/api/imagebuilder.md): Build custom VM images with SSH pre-configured using Docker
- [ImageManager](https://mintlify.wiki/CelestoAI/SmolVM/api/imagemanager.md): Download, cache, and verify pre-built VM images
- [ImageSource](https://mintlify.wiki/CelestoAI/SmolVM/api/imagesource.md): Define downloadable VM image metadata with verification
- [NetworkConfig](https://mintlify.wiki/CelestoAI/SmolVM/api/networkconfig.md): Network configuration model for SmolVM guests.
- [SmolVM](https://mintlify.wiki/CelestoAI/SmolVM/api/smolvm.md): High-level interface for managing a single microVM with automatic configuration and lifecycle management
- [SSHClient](https://mintlify.wiki/CelestoAI/SmolVM/api/sshclient.md): Execute commands on microVM guests via persistent SSH connections.
- [VMConfig](https://mintlify.wiki/CelestoAI/SmolVM/api/vmconfig.md): Configuration model for creating a microVM with resource allocation, disk settings, and boot parameters
- [VMInfo](https://mintlify.wiki/CelestoAI/SmolVM/api/vminfo.md): Runtime information about a VM including status, configuration, network details, and process information
- [smolvm cleanup](https://mintlify.wiki/CelestoAI/SmolVM/cli/cleanup.md): Clean stale SmolVM resources and VMs
- [smolvm doctor](https://mintlify.wiki/CelestoAI/SmolVM/cli/doctor.md): Run host diagnostics for the selected backend
- [smolvm env](https://mintlify.wiki/CelestoAI/SmolVM/cli/env.md): Manage environment variables on a running VM
- [CLI Overview](https://mintlify.wiki/CelestoAI/SmolVM/cli/overview.md): Overview of the SmolVM command-line interface and installation
- [smolvm ui](https://mintlify.wiki/CelestoAI/SmolVM/cli/ui.md): Start the SmolVM dashboard UI server
- [Firecracker vs QEMU Backends](https://mintlify.wiki/CelestoAI/SmolVM/concepts/backends.md): Choose the right microVM backend for your platform and understand their trade-offs
- [Network Configuration](https://mintlify.wiki/CelestoAI/SmolVM/concepts/networking.md): Understand TAP devices, NAT, port forwarding, and VM network isolation in SmolVM
- [Architecture Overview](https://mintlify.wiki/CelestoAI/SmolVM/concepts/overview.md): Understand SmolVM's microVM architecture and how it provides secure isolation for AI agents
- [Security Model](https://mintlify.wiki/CelestoAI/SmolVM/concepts/security.md): Understand SmolVM's security guarantees, isolation mechanisms, and operational guidance
- [AI Agent Integration](https://mintlify.wiki/CelestoAI/SmolVM/guides/ai-agent-integration.md): Build secure sandboxes for AI agents using SmolVM's isolation and safety features
- [Basic Usage](https://mintlify.wiki/CelestoAI/SmolVM/guides/basic-usage.md): Learn the fundamentals of creating and interacting with SmolVM instances
- [Custom Images](https://mintlify.wiki/CelestoAI/SmolVM/guides/custom-images.md): Build custom rootfs and kernel images for SmolVM
- [Environment Variables](https://mintlify.wiki/CelestoAI/SmolVM/guides/environment-variables.md): Inject and manage environment variables in SmolVM guests
- [Port Forwarding](https://mintlify.wiki/CelestoAI/SmolVM/guides/port-forwarding.md): Expose guest services to your host machine using SmolVM's port forwarding features
- [VM Lifecycle Management](https://mintlify.wiki/CelestoAI/SmolVM/guides/vm-lifecycle.md): Create, start, stop, and manage SmolVM instances throughout their lifecycle
- [Installation](https://mintlify.wiki/CelestoAI/SmolVM/installation.md): Detailed installation instructions for SmolVM on Linux and macOS
- [Introduction](https://mintlify.wiki/CelestoAI/SmolVM/introduction.md): Lightning-fast, secure microVM runtime for AI agents and untrusted code execution
- [Quickstart](https://mintlify.wiki/CelestoAI/SmolVM/quickstart.md): Get started with SmolVM in minutes - from installation to running your first secure sandbox