examples/README.md
Examples showing how to use the microsandbox SDK in Rust, Python, and TypeScript.
Each language directory has its own README with setup and run instructions.
| Language | Directory | README |
|---|---|---|
| Rust | rust/ | rust/README.md |
| Python | python/ | python/README.md |
| TypeScript | typescript/ | typescript/README.md |
Some examples use git submodules for sample Alpine rootfs assets:
git submodule update --init --recursive
| Example | Description |
|---|---|
root-oci | Create a sandbox from an OCI image (e.g. alpine) |
root-bind | Create a sandbox from a local bind-mounted directory |
root-block | Create a sandbox from a qcow2 disk image |
rootfs-patch | Pre-boot filesystem modifications (files, dirs, appends) |
init-handoff | Hand PID 1 inside the guest off to systemd |
volume-named | Persistent named volume shared between sandboxes |
volume-disk | Mount raw / qcow2 disk images at arbitrary guest paths |
fs-read-stream | Stream a large file from the sandbox in chunks |
metrics-stream | Subscribe to streaming resource metrics |
shell-attach | Interactive terminal session inside a sandbox |
net-basic | DNS resolution, HTTP fetch, interface status |
net-dns | DNS filtering — block domains and suffixes |
net-policy | Network policies — public-only, allow-all, no-network |
net-ports | Port publishing — expose guest services on host ports |
net-secrets | Secret injection with TLS placeholder substitution |
net-tls | TLS interception with per-domain cert generation |