Key takeaways
- OpenShell now documents Docker, Podman, MicroVM, and Kubernetes compute drivers; isolation depends on the selected driver.
- HTTP inspection defaults to audit mode, which forwards violations; blocking requires enforcement mode and appropriate rules.
- Provider placeholders can keep real credentials outside the agent, but permitted API operations still need explicit limits.
- The v0.0.116 release remains alpha, with supported Linux and Apple Silicon macOS paths and experimental Windows WSL2 support.
FAQ
What is NVIDIA OpenShell?
An open-source runtime for operating agent sandboxes with filesystem, process, network, credential, and inference policy on infrastructure you manage.
Does OpenShell support microVMs?
Yes. Its MicroVM driver uses libkrun with macOS Hypervisor.framework or Linux KVM; the documentation also describes QEMU-backed Linux GPU guests.
Does every network rule block violations?
No. An endpoint without a protocol setting receives connection-level checks; inspected requests default to audit mode. Set enforce and explicit request rules when blocking is required.
How much does OpenShell cost?
The runtime is Apache-2.0 free software. Infrastructure, model usage, and operation of the deployment remain separate costs.
Executive Summary
NVIDIA OpenShell is an open-source agent runtime built primarily in Rust. A gateway manages sandboxes, while an in-sandbox supervisor constrains agent processes and proxies their network access. Declarative policy covers filesystem access, process restrictions, permitted endpoints, and model routing.[1][2]
Its compute options now include Docker, Podman, MicroVM, and Kubernetes. The MicroVM driver adds a virtual-machine boundary to the deployment options; the old description of OpenShell as exclusively container-based is no longer accurate. However, choosing a driver does not make every policy blocking: the documented defaults for HTTP inspection and unavailable Landlock restrictions require attention.[3][4][5]
| Attribute | Verified September 15, 2026 |
|---|---|
| Maintainer | NVIDIA[1] |
| Latest release | v0.0.116, August 28, 2026; alpha status[6][3] |
| Repository | 8,623 stars and 1,252 forks on GitHub[1] |
| License | Apache-2.0[1] |
| Host support | Linux and Apple Silicon macOS; Windows through WSL2 is experimental[7] |
The agent sandbox comparison provides broader category context. This review uses the released README and documentation, distinguishing them from newer changes on the repository's main branch.
Product Overview
An operator creates a sandbox, selects its image and compute driver, attaches policy and providers, then runs an agent inside it. The released README lists integrations for Claude Code, Codex, OpenCode, and Copilot CLI, with OpenClaw and Hermes running through NemoClaw. A terminal dashboard exposes gateways, sandboxes, and providers.[3]
| Surface | Purpose and availability |
|---|---|
| CLI | Binary installation and sandbox/provider lifecycle commands[3] |
| Python SDK | The openshell PyPI package is an SDK; it does not install the CLI[3] |
| Ubuntu snap | Canonical announced snap distribution on June 1, 2026[8] |
| Kubernetes deployment | Helm-based cluster deployment, marked experimental in the released README[3] |
Network and inference settings can change while a sandbox runs; filesystem and process restrictions are established at creation. Operators should distinguish a constrained process's inability to remove restrictions from the control plane's ability to approve and deploy policy changes.[5][2]
Technical Architecture
The CLI talks to a gateway that holds lifecycle and policy state. The supervisor applies restrictions to the agent child and mediates outbound traffic. Linux enforcement combines Landlock, seccomp, privilege reduction, and proxy policy; the host, gateway, supervisor, hypervisor or container runtime, and selected image remain part of the trusted deployment.[2][5]
Compute and host boundaries
| Option | Documented boundary or requirement |
|---|---|
| Docker / Podman | Container-backed execution with OpenShell's process and proxy restrictions[4] |
| MicroVM | libkrun with Hypervisor.framework on macOS or KVM on Linux; QEMU is documented for Linux GPU guests[4] |
| VM storage | Prepared root image and a writable per-sandbox overlay retained across stops; deleting the sandbox removes its local state[4] |
| Linux hosts | Debian/Ubuntu, x86-64 or ARM64; available kernel features affect enforcement[7] |
| macOS / Windows | Apple Silicon macOS is supported; Windows WSL2 with Docker Desktop is experimental[7] |
A container driver does not create a separate guest kernel per sandbox. A MicroVM does, but its existence is not proof of resistance to every guest escape or of a correctly configured egress policy. GPU support also requires the relevant runtime, device configuration, and image; it is not implied by the default image.[4][3]
Credentials and inference
The detailed Providers v2 documentation describes static credential placeholders inside the sandbox, with real values resolved by the proxy for matching endpoint bindings. That is more precise than the released README's broad environment-injection description. Endpoint bindings match host, port, and canonical path; the binding itself is not scoped to a particular binary, although network policy separately checks which binary may reach the endpoint.[9][3]
Managed inference routes requests to configured backends. This controls the destination, not the semantic safety of everything the agent sends to an allowed destination. Neither credential substitution nor model routing should be described as automatic sensitive-data classification.[2][9][5]
Strengths
- Policy is reviewable. File, process, endpoint, and request rules can be inspected alongside deployment configuration.[5]
- Compute options have broadened. Teams can evaluate container and VM-backed execution through the same runtime architecture.[4]
- Request controls go beyond destination allowlists. Configured REST, GraphQL, and WebSocket inspection can constrain supported request forms.[5]
- Credential proxying reduces raw-secret exposure. Supported placeholder flows keep the real value outside the agent while still permitting authenticated requests.[9]
Cautions
- Audit mode does not block. When L7 inspection is enabled,
enforcementdefaults toaudit: violations are logged and forwarded. Useenforcement: enforcewith suitable rules to block them.[5] - Connection checks are not request checks. Omitting
protocolyields host/port/binary checks followed by an uninspected tunnel. Credentialed endpoints require an explicit exception for this mode.[5] - Landlock can degrade by configuration. The default
best_effortmode may continue when support or configured paths are unavailable, emitting a high-severity finding.hard_requirementmakes those conditions abort instead.[5] - TLS exceptions remove controls.
tls: skipdisables inspection and placeholder rewriting for that endpoint. It is a compatibility escape hatch with consequences, not a harmless transport option.[5] - Authorized access can still do damage. An approved destination can receive permitted data or API actions. Approval also becomes a durable policy revision for that sandbox instance; operators must review its scope.[5]
- Release maturity remains limited. The released README labels the project alpha, with experimental paths including WSL2, Helm deployment, and GPU passthrough. Validate the specific combination you plan to operate.[3][7]
What Developers Say
Hector Flores's DEV article, published March 23 and updated June 15, 2026, describes adding Copilot CLI support and praises readable policy configuration. He also reports sparse documentation and a developing provider ecosystem. He is a contributor describing his experience, not an independent security auditor; his early account does not establish the limits of the August release.[10]
This review verified documentation and release contents but did not deploy OpenShell or run adversarial tests. The developer account is useful implementation context, not representative adoption evidence or proof that enforcement cannot be bypassed.
Pricing & Licensing
| Offering | Terms |
|---|---|
| Open-source runtime | Apache-2.0; available for self-hosting[1] |
| Deployment and model use | Operators provide the runtime infrastructure and configured inference providers; their costs remain separate[3] |
The reviewed sources establish availability of the runtime and SDK. They do not establish a hosted-service SLA, a commercial support commitment, or a total operating cost.
Competitive Positioning
OpenShell is worth evaluating when the requirement combines agent lifecycle management, policy, provider credentials, and a choice of compute drivers. Describing it only as a governance wrapper omits its gateway and SDK; describing it as a hosted cloud service omits the operational work its deployment requires.[2][3]
Use the profiles for E2B, Microsandbox, and Anthropic Sandbox Runtime to compare deployment requirements. Do not choose between them on the obsolete premise that OpenShell has no MicroVM option. Its use of libkrun also makes that underlying library relevant to a VM-backed evaluation.[4]
Ideal Customer Profile
Best fit: platform teams prepared to operate an alpha runtime, review effective policy, and test their selected host, driver, agent, and credential combination.
Poor fit: teams expecting a default YAML file to provide complete application authorization, or a source license to include managed operations and support.
Viability Assessment
NVIDIA maintenance, a recent tagged release, and Canonical packaging are concrete evidence of continued work and distribution. The dated star count measures repository interest. None of these establishes production adoption, guaranteed long-term funding, or an unlimited support commitment.[1][6][8]
The relevant next milestone is a stable deployment and compatibility contract for the combinations teams actually use. That is an assessment criterion, not a promised release date.
Bottom Line
OpenShell now combines a broader compute layer with detailed access policy and credential mediation. The evaluation should begin with the actual driver and effective enforcement settings: a VM boundary, an audit rule, and an allowed credential route each solve a different problem.
Recommended for: teams willing to validate and operate the full agent runtime and policy stack.
Not recommended for: treating alpha defaults as a complete security policy or assuming every permitted API call is safe.
Outlook: watch release stability, enforcement configuration, and provider behavior rather than inferring maturity from repository popularity.
Research by Ry Walker • methodology
Sources
- [1] NVIDIA OpenShell GitHub Repository
- [2] OpenShell Architecture
- [3] OpenShell v0.0.116 README
- [4] OpenShell Sandbox Compute Drivers
- [5] OpenShell Security Best Practices
- [6] OpenShell v0.0.116 release
- [7] OpenShell Support Matrix
- [8] Canonical: NVIDIA OpenShell Now Available as a Snap for Ubuntu
- [9] OpenShell Providers v2
- [10] Hector Flores: NVIDIA OpenShell — The Sandbox Your AI Agents Should Be Running In