Psroot containers follow a Docker-like lifecycle: create → start → exec → stop → remove.
For quick usage, psroot shell does all of this in one command. For more control, use the individual commands below.
psroot create --name myapp --memory 512M --cpu 5000 --tool node
# Output: psroot-a1b2c3d4This creates the container (provisions rootfs, copies tools) but doesn't start it.
| Flag | Default | Description |
|---|---|---|
--name |
auto-generated | Human-readable name |
--rootfs |
auto-created | Path to root filesystem (empty = auto) |
--command |
cmd.exe |
Command to run on start |
--memory |
1G |
Memory limit (e.g., 512M, 2G) |
--cpu |
10000 |
CPU rate 1–10000 (10000 = 100%) |
--max-procs |
100 |
Max concurrent processes |
--tool |
none | Tools to install: node, rust-bin, winget |
--network |
none |
Network mode: none, outbound, full |
--volume |
none | Mount host path: C:\src:C:\app or C:\src:C:\app:ro |
--env |
none | Set env var: KEY=VALUE |
--workdir |
C:\ |
Working directory inside container |
--silo |
false | Enable server silo (requires admin) |
psroot start psroot-a1b2c3d4
# Output: Started psroot-a1b2c3d4Runs the container's configured command inside the sandbox.
psroot exec psroot-a1b2c3d4 "node -e \"console.log('hello')\""
# Output: PID: 12345Runs an additional command inside an existing container.
psroot stats psroot-a1b2c3d4Shows live resource usage:
Container: psroot-a1b2c3d4
Memory Usage: 42 MB
Peak Memory: 67 MB
CPU (kernel): 156 ms
CPU (user): 892 ms
Active Procs: 3
Total Procs: 7
psroot stop psroot-a1b2c3d4
# Output: Stopped psroot-a1b2c3d4Terminates all processes in the container's job object.
psroot rm psroot-a1b2c3d4
# Output: Removed psroot-a1b2c3d4
# Force remove (stops first if running)
psroot rm -f psroot-a1b2c3d4Deletes the container's rootfs and metadata.
psroot lsID STATUS CREATED
psroot-a1b2c3d4 running 2026-04-19 10:30:00
psroot-e5f6g7h8 stopped 2026-04-19 09:15:00
Filter by status:
psroot ls --status runningpsroot shell --tool node --network outboundThis is equivalent to:
psroot create --tool node --network outbound --command cmd.exe- Attach interactive stdin/stdout
- Wait for
exit psroot rm <id>(auto-cleanup)
The container is automatically removed when you exit the shell.