Skip to main content

​
Welcome to Hatch

Hatch is a wrapper around Firecracker for spinning up microVMs, designed for agentic workloads. It provides a REST API for lifecycle management, wake-on-request functionality, snapshot/restore for idle VMs, and a subdomain-based reverse proxy.

Quickstart

Get your first VM running in minutes

Architecture

Understand how Hatch works

API Reference

Explore the REST API

Installation

Set up Hatch on your infrastructure

​
Key Features

MicroVM Orchestration

Manage Firecracker microVMs through a simple REST API with full lifecycle control

Subdomain Routing

Automatic reverse proxy routing to VMs via subdomains with wake-on-request support

Serverless Pattern

Idle VMs automatically snapshot to S3 and wake transparently on next request

Full Networking

Complete networking stack with TAP devices, bridge, DHCP, and NAT

SSH Gateway

Port forwarding with wake-on-SSH for seamless access to snapshotted VMs

Snapshot/Restore

Full VM state persistence to S3-compatible storage with fast restore

​
Quick Example

Create your first VM with networking and cloud-init: 
curl -X POST http://localhost:8080/vms \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "enable_network": true,
    "user_data": "#cloud-config\nusers:\n  - name: hatch\n    groups: [sudo]\n    shell: /bin/bash\n    sudo: [\"ALL=(ALL) NOPASSWD:ALL\"]\n    ssh_authorized_keys:\n      - ssh-rsa AAAA..."
  }'
Then SSH into your VM: 
ssh -p <ssh_port> hatch@<host-ip>

​
Use Cases

Agentic Workloads

Run autonomous agents in isolated microVMs with automatic scaling

Development Environments

Spin up ephemeral dev environments that snapshot when idle

CI/CD Runners

Isolated build environments that wake on webhook triggers

Testing Infrastructure

Create and destroy test VMs with snapshot/restore for consistent state

​
Get Started

Quickstart

Launch your first VM

Core Concepts

Learn the fundamentals

API Docs

Explore the API

Build docs developers (and LLMs) love

Get started for freeTalk to us