No entries match these filters. Clear filters
OpenShell adds a service-discovery API, --timeout for sandbox create, and output format flags for workspace commands︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSIONHomebrew git
Homebrew
copy
$ brew install openshell
$ brew upgrade openshell
git
copy
$ git clone --branch v0.1.9 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.1.9
Homebrew lists this version · checked 18 Nov
└──▷ TRY IT
Override the default 300-second provisioning wait when creating a sandbox in a slow environment, such as a GPU GPU A graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. -backed isolation backend.
copy
$ openshell sandbox create --name gpu-agent --timeout 600
Emit workspace details as JSON for scripted consumption or piping into jq.
copy
$ openshell workspace get my-workspace -o json
Set how long the CLI waits for sandbox provisioning with openshell sandbox create --timeout <SECONDS>, overriding the 300-second default and OPENSHELL_PROVISION_TIMEOUT.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Control sandbox startup timeouts for slow isolation backends with the provisioning_repair_window_seconds, runtime_bootstrap_grace_seconds, and sandbox_attach_request_timeout_seconds gateway settings. Not checked yet Get workspace output in table, JSON, or YAML with -o/--output table|json|yaml on openshell workspace create and openshell workspace get. Not checked yet A new openshell.v1.ServiceDiscovery service adds GetServiceRouteSnapshot and WatchServiceRoutes so proxies and controllers can discover a workspace's service routes. Not checked yet Inspected HTTP responses now carry an X-OpenShell-Request-ID header that links them to OCSF OCSF An open schema standard, maintained by the OCSF community under CISA and industry backing, that defines a common event format so cyber tools can share and ingest log data without per-source normalization work. records and supervisor traces. Not checked yet
+4 more
show less
Enable streaming HTTP middleware hooks with the openshell.supervisor-middleware.http-hooks capability. Not checked yet A reusable Grafana monitoring mixin now provides dashboards for operational health, operational logs, and OCSF events in Kubernetes deployments. Not checked yet Gateway delete records now name the workspace and resource deleted, and show when a delete found nothing to remove or is still in progress. Not checked yet New metrics report supervisors per gateway and the busiest supervisor's sandbox count, and shared supervisors now spread evenly across gateway replicas when they connect. Not checked yet
A new openshell.v1.ServiceDiscovery service adds GetServiceRouteSnapshot and WatchServiceRoutes so proxies and controllers can discover a workspace's service routes. Not checked yet Inspected HTTP responses now carry an X-OpenShell-Request-ID header that links them to OCSF OCSF An open schema standard, maintained by the OCSF community under CISA and industry backing, that defines a common event format so cyber tools can share and ingest log data without per-source normalization work. records and supervisor traces. Not checked yet Enable streaming HTTP middleware hooks with the openshell.supervisor-middleware.http-hooks capability. Not checked yet A reusable Grafana monitoring mixin now provides dashboards for operational health, operational logs, and OCSF events in Kubernetes deployments. Not checked yet
5 more in Everything
└──▷ BREAKING ON UPGRADE
! The Go SDK has moved to github.com/ai-openshell/sdk-go; github.com/NVIDIA/OpenShell/sdk/go is deprecated and its last version is v0.1.8 — update module imports to the new path.! Wildcard network policy endpoints no longer allow private IP literals on their own — add an exact endpoint or an allowed_ips grant for any private address your sandboxes still need to reach.! On Postgres, gateway migration 010 builds indexes on the objects table with a plain CREATE INDEX, which blocks writes to that table while it runs — large deployments should plan for downtime during upgrade.! The Helm chart now enables the gateway's Prometheus endpoint with metrics.enabled instead of a port value; charts that set service.metricsPort to 0 or false now fail to render — set metrics.enabled=false and keep a valid port instead.! Middleware selectors can no longer include a port and now fail validation — remove the port from any selectors.! The legacy EvaluateHttpRequest and HttpResponsePreReturn HTTP middleware hooks are deprecated and will be removed in 0.2.0.! Authorization denial OCSF records for write methods now report Create, Update, or Delete instead of Other (99) — update queries to select denials by class_uid: 6003 and status_id: 2 rather than type_uid: 600399.! The Helm chart no longer sets a process-wide SSL_CERT_FILE for a private OIDC OIDC OpenID Connect, a sign-in protocol built on OAuth 2.0. An application uses identity information from a trusted provider instead of maintaining a separate password for each user. CA; the CA from server.oidc.caConfigMapName now applies only to OIDC discovery and JWKS JWKS A JSON Web Key Set, a published collection of cryptographic keys. Applications use it to find the public key needed to verify a token's signature. requests — outside Helm, set it with [openshell.gateway.oidc] ca_bundle, --oidc-ca-bundle, or OPENSHELL_OIDC_CA_BUNDLE.
OpenShell adds metrics TLS/mTLS mTLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. , TRACEPARENT TRACEPARENT An HTTP header defined by the W3C Trace Context standard that carries a trace ID and span ID across service boundaries, letting distributed tracing systems stitch together request flows across multiple services. forwarding, Kubernetes supervisor runtime class, and Helm Helm A package manager for Kubernetes, maintained by the CNCF, that lets tools define, version, and deploy clusters of Kubernetes resources as a single reusable unit called a chart. priority/topology controls︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSIONHomebrew git
Homebrew
copy
$ brew install openshell
$ brew upgrade openshell
git
copy
$ git clone --branch v0.1.8 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.1.8
Homebrew lists this version · checked 11 Nov
└──▷ USE IT
Pin dedicated supervisor pods to a hardware-isolated runtime class in Kubernetes for stronger workload separation.
gateway.toml
copy
[openshell.drivers.kubernetes]
supervisor_runtime_class_name = "kata-containers"
Carry a CI trace context into gateway spans so the full pipeline appears as one distributed trace.
copy
$ export TRACEPARENT=00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01
openshell sandbox create --name ci-run -- python run_agent.py
Serve /metrics over TLS or mutual TLS mutual TLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. by configuring the metrics listener through gateway TOML TOML A configuration file format designed to be minimal and readable, mapping unambiguously to a hash table; cyber tools use it as a structured alternative to YAML or INI for config files. , CLI flags, environment variables, or Helm Secrets — plaintext remains the default.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Set supervisor_runtime_class_name in the Kubernetes driver config to assign a runtime class to dedicated supervisor pods. Not checked yet Set priorityClassName and topologySpreadConstraints in the Helm chart to control gateway pod scheduling. Not checked yet Forward TRACEPARENT and TRACESTATE from the CLI environment to the gateway, so CI pipeline traces parent gateway spans. Not checked yet OCSF OCSF An open schema standard, maintained by the OCSF community under CISA and industry backing, that defines a common event format so cyber tools can share and ingest log data without per-source normalization work. HTTP and API audit events now correlate with sampled OpenTelemetry OpenTelemetry An open standard and set of tools for collecting traces, metrics and logs from applications. It lets services export observability data without tying instrumentation to one monitoring vendor. traces, and OTLP OTLP OpenTelemetry Protocol, a standard way to send traces, metrics and logs between applications, collectors and monitoring systems. It lets telemetry move across compatible tools. log records carry trace and span context. Not checked yet
+2 more
show less
Supervisors now advertise installed application routes, so gateways can discover them for both dedicated and shared supervisors. Not checked yet In multi-replica gateways, shared-supervisor pool sandbox sessions now stay on the gateway replica that serves their supervisor, including across failures. Not checked yet
Serve /metrics over TLS or mutual TLS mutual TLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. by configuring the metrics listener through gateway TOML TOML A configuration file format designed to be minimal and readable, mapping unambiguously to a hash table; cyber tools use it as a structured alternative to YAML or INI for config files. , CLI flags, environment variables, or Helm Secrets — plaintext remains the default.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Set supervisor_runtime_class_name in the Kubernetes driver config to assign a runtime class to dedicated supervisor pods. Not checked yet Set priorityClassName and topologySpreadConstraints in the Helm chart to control gateway pod scheduling. Not checked yet Forward TRACEPARENT and TRACESTATE from the CLI environment to the gateway, so CI pipeline traces parent gateway spans. Not checked yet Supervisors now advertise installed application routes, so gateways can discover them for both dedicated and shared supervisors. Not checked yet
2 more in Everything
└──▷ BREAKING ON UPGRADE
!
Static provider credentials without placement metadata now resolve only in the `Authorization` header or through explicitly enabled body/WebSocket rewrite policies; custom headers such as `x-api-key`, query parameters, and path slots require an explicit placement declaration. `auth_style` selects the active placement and fields for other styles are ignored. Upgrade the gateway before the supervisor and update existing imported profiles.
Our best guess
!
REST endpoints now return `403` for HTTP upgrade requests in both enforce and audit modes. Configure WebSocket traffic with `protocol: websocket` and explicit handshake and message rules; `websocket_credential_rewrite: true` now requires a WebSocket endpoint.
Our best guess
!
OCSF sandbox attribution moved: supervisor events use `device.container.uid` and `device.container.name`; gateway API Activity and Detection Finding events use `resources` entries with `type: "sandbox"`; other gateway classes use `unmapped.sandbox_id` and `unmapped.sandbox_name`. SIEM parsers reading top-level `container.uid` or `container.name` must update their mappings.
Our best guess
!
Sandboxes now fail to launch when a filesystem policy path goes through a symlink inside a writable workspace, including in best-effort mode. Use the symlink's target path in the policy instead.
Our best guess
!
Transparent TCP connections now evaluate IPv4-mapped IPv6 destinations as IPv4. Change endpoint rules such as `host: "::ffff:203.0.113.7"` to `host: "203.0.113.7"`.
Our best guess
!
The Go SDK module `github.com/NVIDIA/OpenShell/sdk/go` is deprecated; switch to `github.com/ai-openshell/sdk-go`.
Our best guess
!
The `openshell` Python SDK wheel and checksum are no longer attached to core GitHub Releases; install via `pip install openshell` from PyPI.
Our best guess
!
The Go SDK now shares `oidc_token.json` with the CLI. Run `openshell gateway login` once to replace token files written by earlier Go SDK releases.
Our best guess
OpenShell adds in-place Kubernetes sandbox updates, OTLP OTLP OpenTelemetry Protocol, a standard way to send traces, metrics and logs between applications, collectors and monitoring systems. It lets telemetry move across compatible tools. /HTTP export, per-collector auth headers, mutual TLS mutual TLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. for OTLP, and containerized browser login via two new env vars︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSIONHomebrew git
Homebrew
copy
$ brew install openshell
$ brew upgrade openshell
git
copy
$ git clone --branch v0.1.7 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.1.7
Homebrew lists this version · checked 4 Nov
└──▷ USE IT
Send agent traces from inside a sandbox to your OTLP collector, authenticated with an MLflow experiment header, without writing an egress rule.
gateway.toml
copy
[openshell.gateway.otlp.agent]
enabled = true
[openshell.gateway.otlp]
protocol = "http/protobuf"
headers_file = "/etc/openshell/otlp-headers.txt"
Connect your OTLP collector over mutual TLS using a private CA, so traces are encrypted end-to-end without a public certificate.
gateway.toml
copy
[openshell.gateway.otlp]
ca_file = "/etc/openshell/pki/ca.pem"
cert_file = "/etc/openshell/pki/client.pem"
key_file = "/etc/openshell/pki/client-key.pem"
Run the CLI inside a container and fix the OAuth callback so browser login completes correctly.
copy
$ docker run --rm -e OPENSHELL_CALLBACK_PORT=9876 -e OPENSHELL_CALLBACK_BIND_ADDRESS=0.0.0.0 -p 9876:9876 my-openshell-cli openshell gateway login
Route sandbox egress through a private PKI PKI A framework of policies, roles, and cryptographic standards for issuing and managing digital certificates that bind public keys to identities, letting tools verify authenticity and encrypt communications without pre-shared secrets. by setting [openshell.supervisor.network].additional_ca_bundle to a PEM bundle, applying to every first-party compute driver.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Forward sandboxed agent OpenTelemetry OpenTelemetry An open standard and set of tools for collecting traces, metrics and logs from applications. It lets services export observability data without tying instrumentation to one monitoring vendor. traces to your collector without an egress rule by adding [openshell.gateway.otlp.agent] with enabled = true to gateway.toml; the supervisor tags each span with the sandbox id before forwarding. Not checked yet Use OTLP/HTTP instead of gRPC gRPC An open-source remote procedure call framework from Google that uses HTTP/2 and Protocol Buffers to let services call each other's functions across a network, giving tools low-latency, strongly typed inter-process communication. for telemetry export by setting protocol = "http/protobuf" on [openshell.gateway.otlp] or any signal sub-table; gRPC remains the default. Not checked yet Authenticate or route OTLP traffic by setting headers or headers_file on [openshell.gateway.otlp] or a signal table, so collectors like MLflow can receive relayed agent traces via x-mlflow-experiment-id. Not checked yet Connect OTLP collectors over mutual TLS or private CAs by setting ca_file, and optionally cert_file and key_file, on [openshell.gateway.otlp] or a signal table. Not checked yet
+4 more
show less
Give each sandbox service a unique hostname when multiple gateways share a cluster by setting service_hostname_format = "hashed" under [openshell.gateway]; the previous readable default is unchanged. Not checked yet Opt into a new supervisor TLS listener that lets declared HTTP and WebSocket WebSocket A protocol that upgrades an HTTP connection into a persistent, full-duplex channel, letting a server push data to a client without repeated polling. Cyber tools use it for real-time event streaming and live command output. sandbox services accept application traffic directly, bypassing the gateway; disabled by default. Not checked yet The Rust, Go, Python, and TypeScript SDKs now send exec calls directly to the gateway replica that owns the sandbox when replica routing is enabled; Go also routes port-forward and SSH tunnel calls, and TypeScript routes port-forward. Not checked yet The Python gRPC bindings now ship typed sync and async stubs, giving editors and type checkers visibility into concrete request and response types. Not checked yet
Route sandbox egress through a private PKI PKI A framework of policies, roles, and cryptographic standards for issuing and managing digital certificates that bind public keys to identities, letting tools verify authenticity and encrypt communications without pre-shared secrets. by setting [openshell.supervisor.network].additional_ca_bundle to a PEM bundle, applying to every first-party compute driver.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Forward sandboxed agent OpenTelemetry OpenTelemetry An open standard and set of tools for collecting traces, metrics and logs from applications. It lets services export observability data without tying instrumentation to one monitoring vendor. traces to your collector without an egress rule by adding [openshell.gateway.otlp.agent] with enabled = true to gateway.toml; the supervisor tags each span with the sandbox id before forwarding. Not checked yet Authenticate or route OTLP traffic by setting headers or headers_file on [openshell.gateway.otlp] or a signal table, so collectors like MLflow can receive relayed agent traces via x-mlflow-experiment-id. Not checked yet Connect OTLP collectors over mutual TLS or private CAs by setting ca_file, and optionally cert_file and key_file, on [openshell.gateway.otlp] or a signal table. Not checked yet Give each sandbox service a unique hostname when multiple gateways share a cluster by setting service_hostname_format = "hashed" under [openshell.gateway]; the previous readable default is unchanged. Not checked yet
+1 more
show less
Opt into a new supervisor TLS listener that lets declared HTTP and WebSocket WebSocket A protocol that upgrades an HTTP connection into a persistent, full-duplex channel, letting a server push data to a client without repeated polling. Cyber tools use it for real-time event streaming and live command output. sandbox services accept application traffic directly, bypassing the gateway; disabled by default. Not checked yet
3 more in Everything
└──▷ BREAKING ON UPGRADE
!
OpenShell now emits only OCSF 1.8.0 records; deployments that relied on 1.1 or 1.3 records will now receive 1.8.0 records. The `ocsf_schema_version` setting, the gateway `schema_version` fields, Helm `server.ocsfLog.schemaVersion`, and `OPENSHELL_OTLP_OCSF_SCHEMA_VERSION` are deprecated and ignored; setting them logs a warning.
Our best guess
!
`config preflight` and gateway startup now reject an `[openshell.gateway.supervisor_pool]` table when the selected driver does not use shared supervision, and also reject a pool recovery timeout shorter than member failure detection.
Our best guess
OpenShell v0.1.6 adds OCSF OCSF An open schema standard, maintained by the OCSF community under CISA and industry backing, that defines a common event format so cyber tools can share and ingest log data without per-source normalization work. audit events, sandbox suspend/resume, shared Kubernetes supervisors, and new Helm Helm A package manager for Kubernetes, maintained by the CNCF, that lets tools define, version, and deploy clusters of Kubernetes resources as a single reusable unit called a chart. chart fields.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSIONHomebrew git
Homebrew
copy
$ brew install openshell
$ brew upgrade openshell
git
copy
$ git clone --branch v0.1.6 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.1.6
Homebrew lists this version · checked 28 Oct
└──▷ TRY IT
Pause a long-running sandbox to free compute resources, then resume it later without losing state.
copy
$ openshell sandbox suspend my-sandbox
# ... later ...
openshell sandbox resume my-sandbox
Enable the shared Kubernetes supervisor so many sandboxes share one process and failed supervisors are covered by pool replicas.
toml
copy
[openshell.drivers.kubernetes]
supervisor_topology = "gateway"
[openshell.gateway]
# gateway TLS is required when supervisor_topology = "gateway"
# In the Helm values, set replica count:
# supervisor:
# replicas: 3
Install the latest prerelease build via the snap beta channel to test upcoming features before a stable release.
copy
$ OPENSHELL_VERSION=pre curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
Adds openshell sandbox suspend and openshell sandbox resume commands to pause and resume sandboxes on supported compute drivers.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds supervisor_topology = "gateway" under [openshell.drivers.kubernetes] to enable an experimental shared supervisor that hosts many sandboxes in one process as a pool that can take over a failed supervisor's sandboxes, with supervisor.replicas to set pool capacity. Not checked yet Adds binding_policy setting (values: allowlist or exact) to require a middleware service to provide specific bindings such as request inspection. Not checked yet Adds server.extraEnv to the Helm chart for passing extra environment variables, including Secret references, to the gateway container, and adds pkiInitJob.podLabels and pkiInitJob.podAnnotations to the Helm chart for the certificate hook pods. Not checked yet Gateways now write OCSF audit events for authorization denials, accepted credentials, SSH session tokens, and sandbox token checks, and raise a High-severity finding when a sandbox credential looks misused. Not checked yet
+2 more
show less
Prerelease builds now publish to the snap's latest/beta channel; OPENSHELL_VERSION=pre install.sh installs from there. Not checked yet Stable releases now tag the Go SDK module as sdk/go/vX.Y.Z so Go tooling and pkg.go.dev show real versions. Not checked yet
Adds openshell sandbox suspend and openshell sandbox resume commands to pause and resume sandboxes on supported compute drivers.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds supervisor_topology = "gateway" under [openshell.drivers.kubernetes] to enable an experimental shared supervisor that hosts many sandboxes in one process as a pool that can take over a failed supervisor's sandboxes, with supervisor.replicas to set pool capacity. Not checked yet Adds binding_policy setting (values: allowlist or exact) to require a middleware service to provide specific bindings such as request inspection. Not checked yet Adds server.extraEnv to the Helm chart for passing extra environment variables, including Secret references, to the gateway container, and adds pkiInitJob.podLabels and pkiInitJob.podAnnotations to the Helm chart for the certificate hook pods. Not checked yet Gateways now write OCSF audit events for authorization denials, accepted credentials, SSH session tokens, and sandbox token checks, and raise a High-severity finding when a sandbox credential looks misused. Not checked yet
+1 more
show less
Prerelease builds now publish to the snap's latest/beta channel; OPENSHELL_VERSION=pre install.sh installs from there. Not checked yet
1 more in Everything
└──▷ BREAKING ON UPGRADE
!
Gateways now refuse to start unless OIDC, mTLS user or operator authentication, or gateway JWTs are configured; for trusted local development only, set `allow_unauthenticated_users = true` under `[openshell.gateway.auth]`.
Our best guess
!
New sandboxes on Kubernetes, Docker, Podman, and VM now open the control connection from sandbox to supervisor in the opposite direction; supervisor and sandbox runtime binaries must be upgraded together because older binaries reject the new sandboxes.
Our best guess
!
External isolation backends: `ResumeBoundaryRequest` field 3 is renamed from `allow_cold_start_fallback` to `restart_if_restore_fails`.
Our best guess
OpenShell v0.1.5 adds push-based config delivery (~100 ms), OCSF OCSF An open schema standard, maintained by the OCSF community under CISA and industry backing, that defines a common event format so cyber tools can share and ingest log data without per-source normalization work. -over-OTLP OTLP OpenTelemetry Protocol, a standard way to send traces, metrics and logs between applications, collectors and monitoring systems. It lets telemetry move across compatible tools. export, virtiofs virtiofs A shared filesystem protocol for virtual machines, maintained by the Linux kernel project, that lets a VM access a host directory with near-native performance by avoiding network filesystem overhead. host mounts, per-sandbox mutation locks, and new CLI flags --annotation and --e︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.1.5 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.1.5
└──▷ USE IT
Reduce policy-change propagation from up to 10 s to ~100 ms by enabling push-based config delivery on the supervisor.
toml
copy
config_delivery_mode = "push"
Stream OCSF audit events into your OTLP pipeline (e.g. a separate security observability backend) without mixing them with traces.
toml
copy
[openshell.gateway.otlp.ocsf]
enabled = true
endpoint = "https://ocsf-collector.example.com:4317"
Pass secrets from the local environment into a new sandbox without exposing them in shell history or process listings.
copy
$ openshell sandbox create --name agent-run --env-from AWS_ACCESS_KEY_ID --env-from AWS_SECRET_ACCESS_KEY --annotation team=security -- python agent.py
Adds config_delivery_mode = "push" supervisor setting to receive configuration changes pushed over the gateway session in ~100 ms instead of up to 10 seconds; polling remains the default.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds [openshell.gateway.otlp.ocsf] config block with enabled = true to export OCSF events as OTLP log records, and allows traces and OCSF events to be sent to separate OTLP endpoints. Not checked yet Adds --annotation KEY=VALUE repeatable flag to openshell sandbox create for setting sandbox annotations from the CLI. Not checked yet Adds --env-from KEY[=ENVVAR] flag to openshell sandbox create to pass sandbox environment variables from the caller's environment without putting values on the command line. Not checked yet Adds OPENSHELL_OCSF_JSON=1 gateway audit sink, now available on all platforms. Not checked yet
+5 more
show less
Adds enable_bind_mounts = true setting in [openshell.drivers.vm] to allow MicroVM sandboxes to mount host directories through virtiofs; supports up to 3 mounts on x86_64 or 32 on aarch64 (QEMU QEMU An open-source machine emulator and virtualizer that lets software run a guest OS or CPU architecture on a different host, giving cyber tools an isolated, inspectable execution environment without dedicated hardware. -backed and GPU GPU A graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. launches are not supported). Not checked yet Adds supervisor_network_mode setting for the Docker supervisor to enable bridge networking (host networking remains the default). Not checked yet Adds allowed_pod_annotations and allowed_pod_labels settings in [openshell.drivers.kubernetes] to allowlist pod annotation and label keys used in sandbox templates. Not checked yet Adds server.dataStorageSize and server.dataStorageClass Helm values to configure the gateway data PVC. Not checked yet Gateway mutation locks are now scoped per workspace and sandbox with bounded waits, preventing bursts of supervisor reconnects from queuing behind a single fleet-wide lock. Not checked yet
Adds config_delivery_mode = "push" supervisor setting to receive configuration changes pushed over the gateway session in ~100 ms instead of up to 10 seconds; polling remains the default.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds [openshell.gateway.otlp.ocsf] config block with enabled = true to export OCSF events as OTLP log records, and allows traces and OCSF events to be sent to separate OTLP endpoints. Not checked yet Adds enable_bind_mounts = true setting in [openshell.drivers.vm] to allow MicroVM sandboxes to mount host directories through virtiofs; supports up to 3 mounts on x86_64 or 32 on aarch64 (QEMU QEMU An open-source machine emulator and virtualizer that lets software run a guest OS or CPU architecture on a different host, giving cyber tools an isolated, inspectable execution environment without dedicated hardware. -backed and GPU GPU A graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. launches are not supported). Not checked yet Adds supervisor_network_mode setting for the Docker supervisor to enable bridge networking (host networking remains the default). Not checked yet Adds allowed_pod_annotations and allowed_pod_labels settings in [openshell.drivers.kubernetes] to allowlist pod annotation and label keys used in sandbox templates. Not checked yet
+1 more
show less
Adds server.dataStorageSize and server.dataStorageClass Helm values to configure the gateway data PVC. Not checked yet
4 more in Everything
└──▷ BREAKING ON UPGRADE
! Supervisor OCSF log files are renamed from openshell-ocsf.YYYY-MM-DD.log to openshell-ocsf.YYYY-MM-DD.jsonl; update any collector glob patterns from openshell-ocsf.*.log to openshell-ocsf.*.jsonl. Old .log files are not migrated.! On Kubernetes, sandbox templates that set pod annotations or labels are now rejected unless an operator allowlists the keys with allowed_pod_annotations and allowed_pod_labels in [openshell.drivers.kubernetes]. API and SDK callers setting SandboxTemplate.labels or SandboxTemplate.annotations (including recovery of timed-out sandboxes) are affected; the openshell CLI and --label metadata labels are not.! The gateway now rejects annotation keys with the reserved internal.openshell.ai/ prefix on CreateSandbox and UpdateConfig.! The Go SDK's SandboxInterface.Create() and CreateFromTemplate() now take functional options (WithLabels() , WithAnnotations() , WithServiceExposures() ) instead of a positional labels argument; the CreateOptions struct has been removed. Call sites must be updated.! External compute drivers that provision openshell-sandbox must update their bootstrap descriptor field from outer_fence to provisioning_evidence.! The snap no longer enables the user gateway service globally; after a direct snap install or if an older revision enabled it globally, run sudo systemctl disable --global snap.openshell.user-gateway.service once, then systemctl --user enable --now snap.openshell.user-gateway.service from the single account that should run the gateway.
v0.1.4 adds gRPC gRPC An open-source remote procedure call framework from Google that uses HTTP/2 and Protocol Buffers to let services call each other's functions across a network, giving tools low-latency, strongly typed inter-process communication. server reflection, operator-only credential retrieval, stable credential placeholders, CLI label management, TypeScript log streaming, and Python sandbox sta︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.1.4 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.1.4
└──▷ TRY IT
Introspect the gateway's gRPC API surface on a local plaintext gateway without any proto files checked out.
copy
$ grpcurl -plaintext localhost:18080 list
grpcurl -plaintext localhost:18080 describe openshell.v1.OpenShell
grpcurl -plaintext -d '{}' localhost:18080 openshell.v1.OpenShell/Health
Adds gRPC server reflection (v1 protocol) to the gateway, enabling grpcurl -plaintext localhost:18080 list and schema introspection without supplying proto files.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds operator-only provider credential retrieval so privileged identities can fetch provider credentials without exposing them to sandbox workloads. Not checked yet Adds createdAtMs field to SandboxRef in the TypeScript SDK for millisecond-precision sandbox creation timestamps. Not checked yet Adds watchLogs with loss-aware resume to the TypeScript SDK for streaming sandbox logs that automatically reconnects and tracks gaps. Not checked yet Exposes sandbox status conditions in the Python SDK so callers can inspect structured lifecycle state. Not checked yet
+2 more
show less
Adds CLI label creation and filtering for providers, enabling operators to tag and query providers by label. Not checked yet Adds snap gateway as a user service by default, removing the need for system-level privileges on snap-based installs. Not checked yet
Adds gRPC server reflection (v1 protocol) to the gateway, enabling grpcurl -plaintext localhost:18080 list and schema introspection without supplying proto files.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds operator-only provider credential retrieval so privileged identities can fetch provider credentials without exposing them to sandbox workloads. Not checked yet Adds watchLogs with loss-aware resume to the TypeScript SDK for streaming sandbox logs that automatically reconnects and tracks gaps. Not checked yet Adds CLI label creation and filtering for providers, enabling operators to tag and query providers by label. Not checked yet
3 more in Everything
v0.1.3 adds OCSF OCSF An open schema standard, maintained by the OCSF community under CISA and industry backing, that defines a common event format so cyber tools can share and ingest log data without per-source normalization work. JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. gateway audit events, bearer auth passthrough, OTLP OTLP OpenTelemetry Protocol, a standard way to send traces, metrics and logs between applications, collectors and monitoring systems. It lets telemetry move across compatible tools. traces from sandbox supervisors, Ctrl-D session detach, gateway capacity metrics with optional HPA, VM host-tool preflight checks, runtime image env overrides, and optional cluster-scoped RBAC RBAC Role-based access control, where permissions are assigned to roles such as reader or administrator and users receive those roles. It makes access easier to manage than individual permission lists. in Helm.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.1.3 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.1.3
Adds feat(cli): detach sandbox sessions with Ctrl-D — press Ctrl-D to detach from a running sandbox session without terminating it. Not checked yet Adds feat(server): write gateway OCSF events to JSONL — the gateway now emits structured audit events in OCSF JSONL format. Not checked yet Adds feat(helm): configure gateway OCSF JSONL output — Helm values expose controls for enabling and routing the gateway's OCSF JSONL audit stream. Not checked yet Adds feat(service): add bearer authorization passthrough — the gateway service layer can forward bearer tokens bearer tokens A credential that grants access to whoever presents it, without a separate proof of possession. Protecting the token matters because a stolen copy can be used by someone else. from inbound requests to upstream endpoints. Not checked yet Adds feat(supervisor): export OTLP traces from sandbox supervisors — sandbox supervisors now emit OpenTelemetry OpenTelemetry An open standard and set of tools for collecting traces, metrics and logs from applications. It lets services export observability data without tying instrumentation to one monitoring vendor. traces over OTLP for distributed tracing pipelines. Not checked yet
+10 more
show less
Adds feat(server): add gateway capacity metrics and optional HPA — the gateway exposes capacity metrics and supports a Horizontal Pod Autoscaler when deployed on Kubernetes. Not checked yet Adds feat(gateway): check VM host tools during config preflight — the gateway now validates that required VM host tools are present before accepting a VM-backed sandbox configuration. Not checked yet Adds feat(gateway): support runtime image env overrides — runtime image environment variables can now be overridden at sandbox launch time. Not checked yet Adds feat(helm): make cluster-scoped RBAC optional — cluster-scoped RBAC can now be disabled in the Helm chart for environments that restrict it. Not checked yet Adds feat(helm): add sandbox UID and GID values — Helm chart gains sandboxUid and sandboxGid values to control the identity under which sandbox workloads run. Not checked yet Adds feat(sandbox): add main restart policy — configure a restart policy for the primary sandbox process. Not checked yet Adds feat(providers): serve sandbox config files on demand — providers can now deliver configuration files into the sandbox at runtime on request. Not checked yet Adds feat(providers): add multiple tokens to one request — a single outbound request can now carry tokens from multiple providers simultaneously. Not checked yet Adds feat(snap): ship the standalone prover binary in the snap — the snap package now includes the standalone formal-verification prover binary. Not checked yet Adds feat(sandbox): write agent output to the container log — agent stdout/stderr is now mirrored to the container log for observability. Not checked yet
15 details in Everything
OpenShell v0.1.0 adds sandbox templates, VM HTTP proxy egress, structured list output, OCSF OCSF An open schema standard, maintained by the OCSF community under CISA and industry backing, that defines a common event format so cyber tools can share and ingest log data without per-source normalization work. schema versioning, and EC EC Elliptic Curve cryptography, a public-key approach where security comes from the algebraic structure of elliptic curves over finite fields, giving tools strong encryption and signatures at smaller key sizes than RSA. /EdDSA EdDSA A fast elliptic-curve signature scheme with small keys, the default for new SSH keys and common in code signing. It is not quantum-safe. JWKS JWKS A JSON Web Key Set, a published collection of cryptographic keys. Applications use it to find the public key needed to verify a token's signature. support.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.1.0 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.1.0
└──▷ TRY IT
Drop into a sandbox for debugging without sourcing .bashrc or .profile, so startup-file side-effects don't interfere with your session.
copy
$ openshell sandbox exec my-sandbox --no-login-shell
Provision a VM-driver sandbox from a pre-built rootfs tar archive instead of a container image — useful when your artifact pipeline produces filesystem tarballs.
copy
$ openshell sandbox create --name rootfs-sandbox --from ./rootfs.tar
Adds --no-login-shell flag to openshell sandbox exec to skip shell startup files when entering a sandbox.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds --from flag accepting a rootfs tar archive as the source for VM driver sandboxes. Not checked yet Adds structured output structured output Forcing a model's response to match a given format or JSON schema, so software can parse it reliably instead of hoping the text is well formed. to openshell list commands for machine-readable results. Not checked yet Adds configurable OCSF schema version for SIEM SIEM Security information and event management, collecting logs from many systems and correlating events to find suspicious activity. Analysts use it to investigate alerts and incidents. backward compatibility. Not checked yet Adds sandbox templates on the server, allowing reusable sandbox configuration to be defined once and referenced at creation time. Not checked yet
+13 more
show less
Supports corporate HTTP forward proxy egress for microVM sandboxes. Not checked yet Supports EC and EdDSA keys in OIDC OIDC OpenID Connect, a sign-in protocol built on OAuth 2.0. An application uses identity information from a trusted provider instead of maintaining a separate password for each user. JWKS validation on the server. Not checked yet Splits the Helm chart into separate gateway and workspace charts. Not checked yet Adds a defaults-without-telemetry feature alias at build time, enabling telemetry-free builds without manual feature flag composition. Not checked yet Broadens HTTP header mutation authority in middleware, expanding the extension surface for interceptors. Not checked yet Defines an HTTP response pre-return interface in middleware for new extension hooks. Not checked yet Preserves exact MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. revision allowlists in policy, enabling pinned MCP version enforcement. Not checked yet Advertises compute resource capabilities from drivers, making sandbox resource metadata visible to the control plane. Not checked yet Makes provider profiles authoritative, so profile definitions drive sandbox authentication rather than being advisory. Not checked yet Delegates sandbox authentication to compute drivers, enabling driver-owned auth flows. Not checked yet Makes the e2e:kubernetes target work transparently on OpenShift OpenShift Red Hat's Kubernetes distribution that adds developer workflows, built-in CI/CD, and stricter security defaults on top of upstream Kubernetes, giving cyber tools a managed container platform with enterprise auth and RBAC already wired in. . Not checked yet Separates public and contributor agent skill workflows in the skills/ directory. Not checked yet Adds Codex Security release qualification to the CI pipeline. Not checked yet
Adds --no-login-shell flag to openshell sandbox exec to skip shell startup files when entering a sandbox.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds --from flag accepting a rootfs tar archive as the source for VM driver sandboxes. Not checked yet Adds configurable OCSF schema version for SIEM SIEM Security information and event management, collecting logs from many systems and correlating events to find suspicious activity. Analysts use it to investigate alerts and incidents. backward compatibility. Not checked yet Adds sandbox templates on the server, allowing reusable sandbox configuration to be defined once and referenced at creation time. Not checked yet Supports corporate HTTP forward proxy egress for microVM sandboxes. Not checked yet
+7 more
show less
Splits the Helm chart into separate gateway and workspace charts. Not checked yet Adds a defaults-without-telemetry feature alias at build time, enabling telemetry-free builds without manual feature flag composition. Not checked yet Defines an HTTP response pre-return interface in middleware for new extension hooks. Not checked yet Preserves exact MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. revision allowlists in policy, enabling pinned MCP version enforcement. Not checked yet Advertises compute resource capabilities from drivers, making sandbox resource metadata visible to the control plane. Not checked yet Separates public and contributor agent skill workflows in the skills/ directory. Not checked yet Adds Codex Security release qualification to the CI pipeline. Not checked yet
6 more in Everything
OpenShell v0.0.115 adds OTLP OTLP OpenTelemetry Protocol, a standard way to send traces, metrics and logs between applications, collectors and monitoring systems. It lets telemetry move across compatible tools. driver trace export, native Windows MXC compute, gateway identity in traces, and OCI OCI Open Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. SBOM SBOM A software bill of materials, an inventory of the components and versions inside an application. It helps teams find affected software when a dependency has a vulnerability or licensing issue. /provenance provenance Evidence recording where a software artifact came from and how it was built, including its source and build process. It helps a consumer check that the artifact matches a trusted build. attestations.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.115 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.115
Exports Kubernetes driver traces over OTLP, enabling distributed tracing pipelines to ingest OpenShell gateway activity. Not checked yet Adds a native Windows MXC compute driver with full server wiring, extending supported compute platforms to Windows MXC. Not checked yet Tags exported traces with gateway identity so multi-gateway deployments can filter and correlate traces per gateway. Not checked yet Publishes OCI SBOM and provenance attestations alongside release artifacts for supply-chain verification. Not checked yet Unifies the local Kubernetes gateway workflow, streamlining Kubernetes-backed development environments. Not checked yet
5 details in Everything
OpenShell v0.0.113 adds OTLP OTLP OpenTelemetry Protocol, a standard way to send traces, metrics and logs between applications, collectors and monitoring systems. It lets telemetry move across compatible tools. driver trace export for Docker and corporate CA trust for Podman sandbox HTTPS HTTPS HTTP carried over an encrypted TLS connection. It protects traffic in transit and lets a browser verify the server's certificate. proxies.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.113 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.113
Exports Docker driver traces over OTLP, enabling distributed tracing of sandbox container operations. Not checked yet Trusts corporate CA certificates for HTTPS proxies and intercepted TLS within Podman-backed sandboxes. Not checked yet
2 details in Everything
OpenShell v0.0.111 adds transparent TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. egress, DNS correlation, OTLP OTLP OpenTelemetry Protocol, a standard way to send traces, metrics and logs between applications, collectors and monitoring systems. It lets telemetry move across compatible tools. driver traces, and standalone first-party compute drivers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.111 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.111
Adds policy DNS correlation store for network policy decisions in Docker and Podman sandboxes. Not checked yet Enables transparent TCP egress and policy DNS enforcement for Docker and Podman runtimes. Not checked yet Exports Podman driver traces over OTLP for observability into sandbox compute activity. Not checked yet Establishes direct TCP egress foundation for policy-governed outbound connections. Not checked yet Adds standalone first-party compute drivers for sandbox execution. Not checked yet
+1 more
show less
Adds a canonical main process to the sandbox runtime. Not checked yet
6 details in Everything
OpenShell v0.0.110 adds OIDC OIDC OpenID Connect, a sign-in protocol built on OAuth 2.0. An application uses identity information from a trusted provider instead of maintaining a separate password for each user. device authorization for headless login, non-root sandbox identities, and persistent credential refresh in providers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.110 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.110
Supports OIDC device authorization grant flow for headless (browserless) login, enabling use in CI/CD and other non-interactive environments. Not checked yet Allows non-root identities inside sandbox environments, expanding the range of workloads and privilege models that sandboxes can support. Not checked yet Stores refresh credentials in credential drivers so providers can maintain long-lived credential sessions without re-authentication. Not checked yet
3 details in Everything
OpenShell v0.0.109 adds OCSF OCSF An open schema standard, maintained by the OCSF community under CISA and industry backing, that defines a common event format so cyber tools can share and ingest log data without per-source normalization work. AI inference event emission via the ai_operation profile on ApiActivity, bumping OCSF schema to v1.8.0.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.109 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.109
OpenShell v0.0.106 adds a complete Go SDK, a TypeScript SDK (@nvidia/openshell-sdk), and cert-manager external issuer with OpenShift OpenShift Red Hat's Kubernetes distribution that adds developer workflows, built-in CI/CD, and stricter security defaults on top of upstream Kubernetes, giving cyber tools a managed container platform with enterprise auth and RBAC already wired in. passthrough Route support in Helm.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.106 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.106
Adds a complete Go SDK with domain clients, authentication, and hardening support. Not checked yet Adds a TypeScript SDK published as @nvidia/openshell-sdk. Not checked yet Adds cert-manager external issuer integration and OpenShift passthrough Route support to the Helm chart deployment. Not checked yet
3 details in Everything
OpenShell v0.0.105 adds stop and start operations for sandboxes.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.105 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.105
OpenShell v0.0.104 adds Windows compilation support, a credential-leak warning on --env, and a glibc-static supervisor variant.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.104 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.104
Adds a warning when --env values passed to the CLI look like credentials, helping catch accidental secret exposure at the command line. Not checked yet Adds Windows compilation support for the gateway and CLI components. Not checked yet Adds a glibc-static supervisor libc variant for environments that require static linking. Not checked yet
3 details in Everything
OpenShell v0.0.103 adds static credential binding to proxy provider endpoints.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.103 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.103
OpenShell v0.0.101 adds credential driver targets and a VM driver built from GitHub sources via Bazel.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.101 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.101
Adds Bazel build targets for the credential driver, enabling it to be compiled as part of the standard build. Not checked yet
1 detail in Everything
OpenShell v0.0.99 adds system CA root mode for sandboxes and honors OCI OCI Open Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. image working directories, plus a TCP_NODELAY latency fix.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.99 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.99
Adds system CA root mode to the build, enabling sandboxes to trust the host's system certificate authorities. Not checked yet
1 detail in Everything
OpenShell v0.0.98 adds OTLP OTLP OpenTelemetry Protocol, a standard way to send traces, metrics and logs between applications, collectors and monitoring systems. It lets telemetry move across compatible tools. trace export from VM driver sandboxes.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.98 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.98
Exports driver traces from VM-backed sandboxes over OTLP for observability into sandbox execution. Not checked yet
1 detail in Everything
OpenShell v0.0.97 adds gateway callback listener negotiation for compute and a prototype Bazel build system.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.97 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.97
Adds gateway callback listener negotiation for the compute layer, enabling dynamic coordination between sandboxes and the gateway control plane. Not checked yet Introduces a prototype Bazel build system, including OpenTelemetry OpenTelemetry An open standard and set of tools for collecting traces, metrics and logs from applications. It lets services export observability data without tying instrumentation to one monitoring vendor. crate targets, for an alternative build path. Not checked yet
2 details in Everything
OpenShell v0.0.96 adds supervisor middleware content guard, Kubernetes PVC storage class config, policy-first OCI OCI Open Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. image identity, workspace authorization, and OTLP OTLP OpenTelemetry Protocol, a standard way to send traces, metrics and logs between applications, collectors and monitoring systems. It lets telemetry move across compatible tools. gateway tracing.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.96 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.96
Adds supervisor middleware content guard example for filtering or inspecting sandbox traffic at the supervisor layer. Not checked yet Supports configuring a custom storageClassName for workspace PVCs in Kubernetes deployments. Not checked yet Introduces policy-first OCI image identity resolution in the sandbox, giving security policies priority in image evaluation. Not checked yet Wires authorization checks into the workspace model, enabling access control enforcement at the workspace level. Not checked yet Exports gateway traces over OTLP, enabling distributed tracing observability for gateway activity. Not checked yet
5 details in Everything
OpenShell v0.0.92 adds JSON/YAML output for sandbox commands and corporate HTTP proxy egress routing.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.92 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.92
└──▷ TRY IT
Pipe sandbox status into jq or other tooling by requesting JSON output — useful in CI pipelines or scripted workflows.
copy
$ openShell sandbox status --output json | jq '.state'
Capture newly created sandbox details in YAML for audit logging or config-as-code workflows.
copy
$ openShell sandbox create --output yaml > sandbox-record.yaml
Adds --output json and --output yaml flags to sandbox get, sandbox status, and sandbox create commands for machine-readable output. Not checked yet Supports routing sandbox egress traffic through a corporate HTTP proxy via the gateway. Not checked yet
2 details in Everything
OpenShell v0.0.90 adds config key support to provider create/update forms in the TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. .
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.90 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.90
OpenShell v0.0.88 adds a workspace resource model with scoping and membership controls.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.88 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.88
OpenShell v0.0.86 adds AWS STS AWS STS AWS Security Token Service, an Amazon Web service that issues short-lived credentials for IAM roles, letting tools authenticate to AWS APIs without storing long-term secrets. AssumeRole refresh, network egress middleware, and TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. panel navigation.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.86 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.86
Adds AWS STS STS AWS Security Token Service, an Amazon Web Services API that issues short-lived credentials for IAM roles, letting cyber tools authenticate to AWS without storing long-term secrets. AssumeRole refresh strategy and aws-s3 profile support for cloud provider integrations. Not checked yet Introduces supervisor middleware framework (RFC-0009) enabling extensible sandbox lifecycle hooks. Not checked yet Adds network egress middleware via the supervisor middleware layer for controlling outbound sandbox traffic. Not checked yet Enables Up/Down arrow key navigation across panels with overflow at list boundaries in the TUI. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The openshell policy prove command and Z3 dependency have been removed; any workflow or script invoking openshell policy prove will break.
OpenShell v0.0.85 adds elevated gateway info surfacing to the gateway component.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.85 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.85
OpenShell v0.0.82 adds Kubernetes sidecar supervisor topology and PVC subPath driver config support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.82 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.82
Adds sidecar supervisor topology for Kubernetes deployments, enabling a new deployment model for supervisor processes. Not checked yet Supports PVC subPath in driver configuration for Kubernetes, allowing more granular persistent volume claim targeting. Not checked yet
2 details in Everything
OpenShell v0.0.76 adds SELinux SELinux A mandatory access control system built into the Linux kernel, maintained by the NSA and Red Hat, that enforces fine-grained policies restricting what processes can access, even if they run as root. bind-mount labels and numeric UID support in sandbox policies.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.76 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.76
Adds SELinux label support for bind mounts in Docker and Podman container runtimes. Not checked yet Enables numeric UIDs (in addition to named users) when specifying sandbox process identity in policies. Not checked yet
2 details in Everything
OpenShell v0.0.75 adds TLS termination for Envoy Gateway ingress and a new manifest-driven gator agent.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.75 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.75
Adds TLS termination support for Envoy Gateway ingress via Helm, enabling encrypted traffic handling at the ingress layer. Not checked yet Introduces a manifest-driven gator agent, allowing agent behavior to be defined and driven through declarative manifests. Not checked yet
2 details in Everything
OpenShell v0.0.74 adds a combined topology config surface for Kubernetes deployments.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.74 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.74
Adds combined topology config surface for Kubernetes, enabling unified topology configuration in a single surface. Not checked yet Breaking: removes SandboxTemplate.volume_claim_templates from the API — configurations referencing this field must be updated. Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! The SandboxTemplate.volume_claim_templates field has been removed from the API
OpenShell v0.0.72 adds AWS SigV4 SigV4 AWS's request-signing protocol that authenticates HTTP calls by hashing the request body, headers, and credentials into a signature; cyber tools use it to talk to AWS APIs without embedding long-lived secrets. proxy signing, JSON-RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. /MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. policy enforcement, and Kubernetes agent-sandbox v1beta1 v1beta1 A Kubernetes API version label marking a resource as beta-quality: past alpha instability but not yet stable enough for a v1 guarantee, signalling that the schema may still change. support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.72 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.72
Adds proxy-side AWS SigV4 credential signing for CONNECT tunnels in sandbox environments. Not checked yet Adds L7 policy enforcement for JSON-RPC and MCP traffic. Not checked yet Supports Kubernetes agent-sandbox v1beta1 API. Not checked yet
3 details in Everything
OpenShell v0.0.71 adds support for out-of-tree compute drivers via a new server socket flag.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.71 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.71
└──▷ TRY IT
Load a custom or out-of-tree compute driver without rebuilding the server — useful when running non-standard GPU GPU A graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. drivers in air-gapped or specialized environments.
copy
$ openshell-server --compute-driver-socket /path/to/custom-driver.sock
OpenShell v0.0.69 adds AWS Bedrock as an inference provider, GCE GCE Google Compute Engine, Google's infrastructure-as-a-service platform for running virtual machines in the cloud; cyber tools use it for scalable, on-demand compute without managing physical hardware. metadata emulation, GPU GPU A graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. count requests, and profile updates.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.69 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.69
Adds AWS Bedrock as a recognized inference provider in sandbox and provider configurations. Not checked yet Adds a GCE metadata emulator for Google Cloud sandbox environments. Not checked yet Supports provider profile updates. Not checked yet Enables GPU count requests via the CLI. Not checked yet
4 details in Everything
OpenShell v0.0.65 adds TLS certificate hot-reload and DeepInfra as a built-in inference provider.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.65 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.65
Supports TLS certificate hot-reload on the server, eliminating restarts when rotating certificates. Not checked yet Adds DeepInfra as a built-in inference provider, expanding the set of natively supported LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. backends. Not checked yet
2 details in Everything
OpenShell v0.0.62 adds HA multi-replica gateway support and system registry with source indicators.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.62 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.62
Adds reconciler lease to the gateway for high-availability multi-replica deployments. Not checked yet Adds system registry support and source indicators to the gateway. Not checked yet
2 details in Everything
OpenShell v0.0.59 adds VM lifecycle extensions and an --env flag for sandbox environment variable injection.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.59 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.59
└──▷ TRY IT
Inject environment variables into a sandbox at creation time — useful for passing secrets or runtime config without baking them into the image.
copy
$ openshell sandbox create --env MY_API_KEY=abc123 --env ENV=production <sandbox-name>
Pass environment variables into a one-off exec inside a running sandbox, e.g. to parameterize a training run.
copy
$ openshell sandbox exec --env BATCH_SIZE=64 --env DEBUG=1 <sandbox-name> -- python train.py
Adds VM lifecycle extensions for managing virtual machine states. Not checked yet New --env flag on sandbox create and sandbox exec commands enables passing environment variables into sandboxes. Not checked yet Adds a generic output formatter across CLI commands, eliminating per-command --output flag duplication. Not checked yet
3 details in Everything
OpenShell v0.0.58 adds Kubernetes driver config passthrough, path-based auth style for providers, and local embeddings embeddings Lists of numbers a model produces to represent the meaning of text, images or code, so similar items sit close together. They power semantic search and RAG. routing.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.58 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.58
Supports driver config passthrough for Kubernetes deployments. Not checked yet Adds path auth style option for providers v2 configuration. Not checked yet Enables local embeddings route for inference. Not checked yet
3 details in Everything
OpenShell v0.0.56 adds multi-file sandbox uploads, a default runtime class for K8s K8s Shorthand for Kubernetes, the open-source container orchestration system originally from Google; cyber tools use it to deploy, scale, and manage containerized workloads across clusters. sandbox pods, and Hermes Agent support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.56 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.56
└──▷ TRY IT
Upload multiple files into a sandbox at creation time instead of running separate upload steps.
copy
$ openShell sandbox create --upload ./model.bin --upload ./config.yaml --upload ./secrets.env
Supports multiple --upload flags on sandbox create, enabling several files to be uploaded in a single command. Not checked yet Adds default_runtime_class_name config option for the Kubernetes driver to set the runtime class on sandbox pods. Not checked yet Adds Hermes Agent to the list of supported agents. Not checked yet
3 details in Everything
OpenShell v0.0.55 adds Google Vertex AI as an inference provider and introduces profile-backed policy visibility.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.55 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.55
Adds Google Vertex AI as a supported inference provider. Not checked yet Introduces profile-backed policy visibility, enabling policy inspection tied to user profiles. Not checked yet
2 details in Everything
OpenShell v0.0.54 adds anonymous usage telemetry opt-out and Kubernetes sandbox image pull secret support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.54 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.54
Adds anonymous usage telemetry with an opt-out mechanism for OpenShell deployments. Not checked yet Supports sandbox image pull secrets in Kubernetes deployments. Not checked yet
2 details in Everything
OpenShell v0.0.53 adds OIDC OIDC OpenID Connect, a sign-in protocol built on OAuth 2.0. An application uses identity information from a trusted provider instead of maintaining a separate password for each user. Bearer auth for the Python SDK, an agentic approval loop for policies, multi-device PCIe passthrough, and TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. pane scrolling.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.53 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.53
Supports OIDC Bearer authentication on SandboxClient in the Python SDK. Not checked yet Adds an agentic approval loop to the policy engine for human-in-the-loop human-in-the-loop Human in the loop, involving a person in an otherwise automated workflow. The person can review, approve, correct or supply information before work continues. control over agent actions. Not checked yet Generalizes PCIe passthrough crate to support multi-device configurations. Not checked yet Adds PageUp/PageDown scrolling to all panes in the terminal UI. Not checked yet
4 details in Everything
OpenShell v0.0.52 adds optional PostgreSQL backing store via Helm and a Nix development shell.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.52 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.52
Adds optional PostgreSQL backing store configurable through the Helm chart. Not checked yet Adds Nix development shell (flake) for reproducible dev environments. Not checked yet
2 details in Everything
OpenShell v0.0.51 adds Docker provisioning progress events, configurable sandbox nproc limits, and handler-level gRPC gRPC An open-source remote procedure call framework from Google that uses HTTP/2 and Protocol Buffers to let services call each other's functions across a network, giving tools low-latency, strongly typed inter-process communication. auth enforcement.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.51 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.51
Adds provisioning progress events for Docker sandboxes, giving visibility into container startup. Not checked yet Declares gRPC authentication mode, scope, and role at the handler level and enforces them at the router. Not checked yet
2 details in Everything
OpenShell v0.0.48 adds automatic provider discovery derived from profiles.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.48 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.48
OpenShell v0.0.47 adds JSON/YAML output for gateway list and per-sandbox authentication to the gateway.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.47 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.47
Adds JSON and YAML output format options to the gateway list CLI command. Not checked yet Adds JSON output format to the policy get CLI command. Not checked yet Enables per-sandbox authentication to the gateway. Not checked yet
3 details in Everything
OpenShell v0.0.45 adds configurable workspace PVC storage size and LSM compatibility checks in agent skills.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.45 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.45
Adds configurable default workspace PVC storage size for Kubernetes deployments. Not checked yet Adds LSM (Linux Security Module) compatibility checks to the review and spike agent skills. Not checked yet
2 details in Everything
OpenShell v0.0.44 adds JSON/YAML sandbox listing, mTLS mTLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. for Podman, nftables network policy, cert generation, and credential refresh foundation.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.44 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.44
└──▷ TRY IT
Generate gateway TLS certificates during RPM-based deployment instead of running the old init-pki.sh script.
copy
$ openshell-gateway generate-certs
Adds -o json and -o yaml output format flags to sandbox list for machine-readable sandbox enumeration. Not checked yet Introduces openshell-gateway generate-certs command, replacing the previous init-pki.sh script for certificate generation in RPM deployments. Not checked yet Enables mTLS support for the Podman compute driver, securing compute node communication. Not checked yet Replaces iptables with nftables for sandbox network policy enforcement. Not checked yet Injects DENO_CERT into the sandbox child environment, enabling custom CA trust for Deno-based sandboxes. Not checked yet
+2 more
show less
Adds resource version compare-and-swap (CAS) support to the database layer. Not checked yet Introduces credential refresh foundation for providers, enabling automated credential rotation. Not checked yet
7 details in Everything
OpenShell v0.0.43 adds OIDC OIDC OpenID Connect, a sign-in protocol built on OAuth 2.0. An application uses identity information from a trusted provider instead of maintaining a separate password for each user. auth, mTLS mTLS Mutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. /HTTPS HTTPS HTTP carried over an encrypted TLS connection. It protects traffic in transit and lets a browser verify the server's certificate. separation, interactive TTY streaming, TOML TOML A configuration file format designed to be minimal and readable, mapping unambiguously to a hash table; cyber tools use it as a structured alternative to YAML or INI for config files. config, and ext4 sandbox disks.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.43 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.43
Separates HTTPS from mTLS authentication on the server, enabling independent configuration of each transport security mode. Not checked yet Adds OIDC authentication support to the TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. , allowing users to authenticate via identity providers identity providers A service that authenticates users and supplies identity information to other applications. It is the sign-in authority behind many single sign-on systems. from the terminal interface. Not checked yet Adds bidirectional streaming for interactive TTY sessions in exec, enabling real interactive shell workflows. Not checked yet Introduces a TOML configuration file for the gateway (RFC 0003), replacing or supplementing prior configuration methods. Not checked yet Supports booting sandboxes from ext4 root disks in the VM layer, enabling persistent or custom disk-backed sandbox environments. Not checked yet
5 details in Everything
OpenShell v0.0.42 adds Podman socket fallback and drops the SSH handshake secret.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.42 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.42
Falls back to Podman socket automatically when Docker is unavailable, broadening container runtime support. Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! The SSH handshake secret has been dropped (refactor!(auth): drop SSH handshake secret); any configuration or tooling that supplies or validates this secret will break on upgrade.
OpenShell v0.0.41 adds agent-driven policy management, sandbox resource flags, and custom CA support for OIDC OIDC OpenID Connect, a sign-in protocol built on OAuth 2.0. An application uses identity information from a trusted provider instead of maintaining a separate password for each user. TLS.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.41 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.41
Adds agent-driven policy management, enabling the agent to participate in policy enforcement decisions. Not checked yet Adds sandbox resource flags to the CLI for controlling resource allocation when creating sandboxes. Not checked yet Supports custom CA certificates for OIDC issuer TLS verification in Helm deployments. Not checked yet
3 details in Everything
OpenShell v0.0.40 adds Kubernetes nodeSelector/toleration support and local-domain service routing in the gateway.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.40 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.40
Supports nodeSelector and tolerations configuration for Kubernetes deployments via platform_config. Not checked yet Adds local-domain service routing in the gateway, enabling resolution and routing to cluster-local services. Not checked yet
2 details in Everything
OpenShell v0.0.39 adds GPU GPU A graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. device-ID awareness in Docker/Podman, Kubernetes ImageVolumeSource sideload support, and TCP TCP A network protocol that delivers a reliable, ordered stream of bytes between two endpoints. It detects lost data and retransmits it. relay forwarding.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.39 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.39
Honors GPU device IDs in Docker and Podman container runtimes, enabling precise GPU assignment within containerized workloads. Not checked yet Supports ImageVolumeSource for Kubernetes supervisor sideload, broadening how supervisor images can be delivered in k8s environments. Not checked yet Adds TCP route forwarding via ForwardTcp in the relay layer, enabling new network-tunneling use cases. Not checked yet
3 details in Everything
OpenShell v0.0.38 adds agent-driven policy management MVP, Snap package support, and Kubernetes service-account token hardening.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.38 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.38
Adds agent-driven policy management MVP, enabling automated policy control through the OpenShell agent. Not checked yet Adds early Snap package support, extending installation options to Snap-managed environments. Not checked yet Disables service account token auto-mounting in the Kubernetes driver, reducing the default credential exposure of OpenShell pods. Not checked yet
3 details in Everything
OpenShell v0.0.37 adds pluggable compute drivers (Docker, Podman, Kubernetes, MicroVM/QEMU QEMU An open-source machine emulator and virtualizer that lets software run a guest OS or CPU architecture on a different host, giving cyber tools an isolated, inspectable execution environment without dedicated hardware. ), OIDC OIDC OpenID Connect, a sign-in protocol built on OAuth 2.0. An application uses identity information from a trusted provider instead of maintaining a separate password for each user. /RBAC RBAC Role-based access control, where permissions are assigned to roles such as reader or administrator and users receive those roles. It makes access easier to manage than individual permission lists. auth, GraphQL L7 policy inspection, CDI GPU GPU A graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. sandboxes, Helm chart, and Debian/RPM/Homebrew packaging.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.37 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.37
└──▷ TRY IT
Install v0.0.37 fresh (or after destroying the old gateway) to get the new system-service-managed gateway with pluggable drivers.
copy
$ curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=v0.0.37 sh
Before upgrading from v0.0.36, clean up incompatible gateway state to avoid data loss.
copy
$ openshell sandbox delete --all && openshell gateway destroy
Adds pluggable compute drivers for Docker, Podman, Kubernetes, and experimental MicroVM-backed sandboxes (RFC-0001 implementation). Not checked yet Adds QEMU VM driver with GPU pass-through support for MicroVM sandboxes. Not checked yet Adds OIDC/Keycloak authentication with RBAC and scope-based permissions for gateway access control. Not checked yet Adds CDI GPU sandboxes via the Docker compute driver. Not checked yet Adds Prometheus metrics infrastructure with gRPC gRPC An open-source remote procedure call framework from Google that uses HTTP/2 and Protocol Buffers to let services call each other's functions across a network, giving tools low-latency, strongly typed inter-process communication. and HTTP request metrics. Not checked yet
+8 more
show less
Adds auto-detection of compute driver at gateway startup. Not checked yet Adds initial provider profiles and sandbox-provider attach lifecycle. Not checked yet Introduces an experimental Helm chart for Kubernetes and OpenShift OpenShift Red Hat's Kubernetes distribution that adds developer workflows, built-in CI/CD, and stricter security defaults on top of upstream Kubernetes, giving cyber tools a managed container platform with enterprise auth and RBAC already wired in. deployments. Not checked yet Adds Debian package publishing; expands RPM and Homebrew packaging. Not checked yet Adopts Kubernetes-style object metadata and labels as the shared entity schema for sandboxes, providers, SSH sessions, and policies. Not checked yet Adds TTY support for exec in the VM driver. Not checked yet Adds guest rootfs derived from sandbox images in the VM driver. Not checked yet Gateway service is now managed as a system service via the package manager instead of CLI commands. Not checked yet
13 details in Everything
└──▷ BREAKING ON UPGRADE
! The openshell gateway start|stop|destroy commands no longer exist; existing gateway state from v0.0.36 or earlier is incompatible and must be destroyed before upgrading.! Public protobuf shapes for core resources (sandboxes, providers, SSH sessions) have changed; existing clients and gateway instances must be recreated.! Policy and draft policy recommendations are now stored in the unified objects table instead of dedicated policy tables; policies must be reconfigured after upgrade.! Gateway persistence now uses a shared entity schema with Kubernetes-style metadata and labels, replacing the previous schema; existing gateway state is not forward-compatible.
OpenShell v0.0.36 adds disabling health check listener, configurable image transfer timeout, and gateway-owned readiness with VM compute driver E2E.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.36 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.36
Adds option to disable the health check listener on the server. Not checked yet Adds configurable timeout for image transfer to gateway containerd. Not checked yet Adds gateway-owned readiness signaling and VM compute driver end-to-end support. Not checked yet
3 details in Everything
OpenShell v0.0.35 adds gRPC gRPC An open-source remote procedure call framework from Google that uses HTTP/2 and Protocol Buffers to let services call each other's functions across a network, giving tools low-latency, strongly typed inter-process communication. -multiplexed SSH relay, request-level tracing, and a dedicated unauthenticated health-check port.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.35 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.35
Adds supervisor-initiated SSH connect and exec tunneled over a gRPC-multiplexed relay between server and sandbox. Not checked yet Adds request-level logging via TraceLayer on the server for per-request observability. Not checked yet Serves health endpoints on a separate, unauthenticated port so load balancers and orchestrators can probe liveness/readiness without credentials. Not checked yet
3 details in Everything
OpenShell v0.0.34 adds incremental sandbox policy updates and VM driver installation with directory resolution.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.34 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.34
└──▷ TRY IT
Install the OpenShell gateway and VM driver with a custom driver directory during VM setup.
copy
$ OPENSHELL_VERSION=v0.0.34 sh install.sh install-vm --driver-dir <path>
Supports incremental sandbox policy updates, enabling partial policy changes without full redeployment. Not checked yet Adds gateway and VM driver installation via install-vm, with --driver-dir flag for custom driver directory resolution. Not checked yet
2 details in Everything
OpenShell v0.0.33 adds a standalone libkrun compute driver for VM-based sandbox execution.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.33 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.33
OpenShell v0.0.32 adds system CA certificate support for upstream TLS and standalone gateway binaries.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.32 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.32
Loads system CA certificates for upstream TLS connections in sandbox environments, enabling trust of enterprise/internal CAs without manual config. Not checked yet Publishes standalone openshell-gateway binaries for direct download and deployment without a full install. Not checked yet
2 details in Everything
OpenShell v0.0.30 adds deny rules to the network policy schema for sandbox environments.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.30 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.30
OpenShell v0.0.26 adds a libkrun microVM gateway crate for VM-based execution.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.26 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.26
OpenShell v0.0.25 adds OCSF OCSF An open schema standard, maintained by the OCSF community under CISA and industry backing, that defines a common event format so cyber tools can share and ingest log data without per-source normalization work. structured logging for sandbox events.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.25 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.25
OpenShell v0.0.23 adds a sandbox exec subcommand with TTY support for interactive shell sessions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.23 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.23
OpenShell v0.0.22 adds gateway state persistence and SSH handshake secret resumption across stop/start cycles.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.22 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.22
OpenShell v0.0.20 switches GPU GPU A graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. injection to CDI and extends L7 credential injection to query params, Basic auth, and URL paths.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.20 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.20
Switches GPU injection to CDI (Container Device Interface) where supported, in both bootstrap/CLI and sandbox device plugin modes. Not checked yet Extends L7 credential injection to cover query parameters, HTTP Basic auth, and URL paths — broadening credential forwarding beyond headers alone. Not checked yet
2 details in Everything
OpenShell v0.0.19 adds L7 query parameter matchers, custom inference timeouts, and streaming SHA256 SHA256 A cryptographic hash function that turns data into a fixed 256-bit fingerprint. It is used to check integrity; hashing does not encrypt the original data. identity resolution.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.19 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.19
Adds L7 query parameter matchers in the sandbox for fine-grained request filtering based on URL query strings. Not checked yet Enables setting a custom inference timeout for inference workloads. Not checked yet Introduces streaming SHA256 hashing and non-blocking spawn for identity resolution, improving performance at scale. Not checked yet
3 details in Everything
OpenShell v0.0.16 adds a dedicated cluster:gpu task to manage GPU GPU A graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. cluster operations.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.16 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.16
└──▷ USE IT
Execute GPU-specific tasks within an OpenShell cluster environment.
shell
copy
openshell run cluster:gpu
Run end-to-end tests that leverage the new GPU task infrastructure.
shell
copy
openshell run e2e:gpu
feat(tasks): add cluster:gpu task and wire e2e:gpu to use it Not checked yet
1 detail in Everything
OpenShell v0.0.15 adds automatic TLS detection with unconditional termination for credential injection in sandboxes.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.15 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.15
Auto-detects TLS and terminates it unconditionally for credential injection in sandbox environments. Not checked yet
1 detail in Everything
OpenShell v0.0.13 adds GitHub Copilot CLI agent provider, standalone OCSF OCSF An open schema standard, maintained by the OCSF community under CISA and industry backing, that defines a common event format so cyber tools can share and ingest log data without per-source normalization work. event library, and a gateway-to-sandbox runtime settings channel.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.13 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.13
Adds GitHub Copilot CLI as an agent provider, enabling Copilot-backed shell interactions. Not checked yet Introduces the openshell-ocsf crate — a standalone library of OCSF event types, formatters, and tracing layers for structured security telemetry. Not checked yet Adds a gateway-to-sandbox runtime settings channel, enabling live configuration updates to sandboxes without restart. Not checked yet Disables NFD/GFD and removes nodeAffinity from the device plugin chart, simplifying GPU GPU A graphics processing unit, a processor that performs many calculations in parallel. AI workloads use GPUs to speed up model training and inference. node configuration. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The UpdateSettings RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. is renamed to UpdateConfig — any client or automation calling UpdateSettings will break.! The pod_template field is removed from the CreateSandbox RPC — any client passing this field will break.
OpenShell v0.0.11 adds OPENSHELL_NO_BROWSER env var to suppress browser popups during authentication
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.11 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.11
└──▷ USE IT
Run CLI authentication in headless or non-interactive environments without opening a web browser.
shell
copy
OPENSHELL_NO_BROWSER=1 openshell auth
Add OPENSHELL_NO_BROWSER environment variable to suppress browser popup during auth Not checked yet
1 detail in Everything
OpenShell v0.0.8 adds host wildcards and multi-port endpoint support in policy definitions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.8 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.8
Supports host wildcards and multi-port endpoints in policy configuration, enabling broader and more flexible access rules. Not checked yet
1 detail in Everything
OpenShell v0.0.7 adds host wildcard and multi-port endpoint support in policy definitions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.0.7 https://github.com/NVIDIA/OpenShell.git
$ git checkout v0.0.7
Supports host wildcards and multi-port endpoints in policy rules, enabling broader and more flexible access control expressions. Not checked yet
1 detail in Everything