A small single-host service that runs Debian 13 virtual machines on Firecracker and gives each one its own SSH credentials. Clients ask an authenticated HTTPS API for a VM; the service boots it, generates an Ed25519 keypair, installs the public key in the guest, and returns the private key, the host and port to connect to, and the guest's SSH host key. On the machine it was developed on, a VM is reachable over SSH about 6 seconds after the request.
It is meant for one machine dedicated to the task, for example to hand out disposable Linux machines to people, CI jobs or LLM agents on a LAN. It is not a cluster scheduler, a container runtime or a general-purpose VM manager.
On the host (Linux x86_64 with KVM, Debian or Ubuntu):
git clone https://github.com/kzsh/snark.git
cd snark
sudo ./setup/install.shOn a client computer:
curl -fsSL https://<host>/install.sh | sh
snark login # paste the token from: sudo cat /etc/snark/api-token
snark create --name web
snark ssh web- Getting started: requirements, server install, first client and VM
- How it works: architecture, host paths, guest image
- Status and limitations
- Configuration and TLS
- Clients:
snark,snark-tui, SSH/scp/rsync, agent, shell completion - Client computers and tokens
- LAN access: per-VM grants to LAN addresses
- HTTP API: routes, and what the install site serves
- Monitoring:
snark-top - Security model and Rate limiting
- Operations: logs, restarts, uninstall
- Building and testing: images, binaries, tests, repository layout
These cover overlapping ground and may fit some needs better:
- ejc3/fcvm runs Podman containers inside Firecracker or Cloud Hypervisor VMs, with snapshot-based fast starts, VM cloning and an HTTP API. It works with container images rather than full Debian systems reached over SSH.
- NVIDIA OpenShell is a policy-enforcing sandbox runtime for AI agents, with its own gateway and CLI.
- firecracker-containerd and Kata Containers run containers in microVMs through container runtimes.
- E2B is an open-source sandbox platform built on Firecracker, designed for multi-node deployments.
- Fly.io Machines is a hosted service whose API design (asynchronous create with a wait endpoint, a per-host daemon with a persisted state machine) influenced this one.
Apache License 2.0, see LICENSE and NOTICE.
The repository contains only this project's own code. Things it downloads or builds at install time keep their own licenses: Firecracker (Apache-2.0), the Debian image (various free licenses) and the guest kernel (GPL-2.0). These are used on the host and not redistributed by this project; if you publish built images, their licenses apply to you.
The prebuilt client binaries statically link Rust crates, the Rust standard library and, on Linux,
musl libc, all under permissive licenses (Apache-2.0, MIT, ISC, BSD-3-Clause, Zlib, Unicode-3.0,
CDLA-Permissive-2.0). client-rs/build-dist.sh generates THIRD-PARTY-LICENSES with
cargo-about; snarkd serves it with LICENSE and
NOTICE under /dl/, and the client installer saves all three to ~/.local/share/snark/licenses/.