Examples showing how to use the microsandbox SDK in Rust, Python, TypeScript, and Go.
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 |
| Go | ../sdk/go/examples/ |
../sdk/go/examples/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 |