Skip to content

Releases

OpenShell Development Build

Pre-release

Choose a tag to compare

@github-actions github-actions released this 18 Mar 21:11
6e24de3

This build is automatically published on every commit to main that passes CI.

NOTE: This is a development build, not a tagged release, and may be unstable.

Quick install

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=dev sh

OpenShell v0.1.9

Choose a tag to compare

@github-actions github-actions released this 17 Nov 19:12
ce58cf8

OpenShell v0.1.9

Quick install

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=v0.1.9 sh

Upgrade notes

  • The Go SDK now lives at github.com/ai-openshell/sdk-go, with versions that follow OpenShell releases. github.com/NVIDIA/OpenShell/sdk/go is deprecated, and its last version is v0.1.8, so switch your module imports to the new path. #5461
  • 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. #5522
  • 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, so large deployments should plan for this during upgrade. The same release lets operators raise the per-caller request-ID limit with mutation_admission_limit_per_caller (up to 1,000,000) and set mutation_replay_window_seconds; defaults are unchanged. #5506
  • The Helm chart now enables the gateway's Prometheus endpoint with metrics.enabled instead of the 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. #5478
  • Middleware selectors can no longer include a port. These selectors never matched, and now fail validation, so remove the port. HTTP middleware also gains new streaming request and response hooks (opt in with the openshell.supervisor-middleware.http-hooks capability), and the legacy EvaluateHttpRequest and HttpResponsePreReturn hooks are deprecated and will be removed in 0.2.0. #4359
  • The gateway now records every user and operator change, such as creating, updating, or deleting a resource, as an OCSF API Activity event. Authorization denials of write methods now report Create, Update, or Delete instead of Other (99), so select denials by class_uid: 6003 and status_id: 2 rather than type_uid: 600399. #5606
  • The Helm chart no longer sets a process-wide SSL_CERT_FILE for a private OIDC CA; the CA from server.oidc.caConfigMapName now applies only to OIDC discovery and JWKS requests. Outside Helm, set it with [openshell.gateway.oidc] ca_bundle, --oidc-ca-bundle, or OPENSHELL_OIDC_CA_BUNDLE. #3673

Bug fixes

  • Long-running sandboxes no longer exit when the supervisor loses its connection to the sandbox a second time, because each connection loss now gets a full reconnect window. #5526
  • A dedicated supervisor now finishes shutting down within 8 seconds after SIGTERM, and Docker gives it 10 seconds before killing it, so stopping a sandbox no longer ends in SIGKILL. A connection to the sandbox that drops during shutdown is no longer recovered. #5342
  • Many idle exec sessions no longer stop the sandbox from accepting new control connections, and the sandbox now reports processes that escape a freeze or stop signal. #5217
  • Stopped sandboxes stay Stopped when an older driver update arrives late, while a later start still shows its progress. #5204
  • Gateways in a multi-replica deployment no longer keep memory for deleted sandboxes, and openshell logs --tail exits after another gateway deletes the sandbox. #5460
  • Sandbox provisioning timeouts on Kubernetes now show the scheduler's reason when a pod can't be scheduled, instead of a generic placeholder. #5344
  • The Helm chart now rejects malformed, out-of-range, or colliding gateway listener ports at render time. #3179
  • Gateway and driver logs only use ANSI colors on a terminal, so logs collected by Kubernetes are plain text; NO_COLOR and FORCE_COLOR override this. #5616
  • The TUI workspace shortcut (w) now cycles through your real workspaces instead of getting stuck on a nonexistent default workspace. #4126
  • rule history now shows the full YYYY-MM-DD HH:MM:SS timestamp like other commands. #5576
  • Updated russh to 0.65.1 to fix SSH security advisories GHSA-9264-jvgf-6w2f and GHSA-736f-c93q-9fwx. #5601
  • Updated hickory-proto to fix DNS parser advisories that affected the supervisor's policy DNS handling. #5513
  • Updated rustix for an upstream memory-safety advisory. #5485

Features

  • Operators can now raise sandbox startup timeouts for slow isolation backends with provisioning_repair_window_seconds, runtime_bootstrap_grace_seconds, and sandbox_attach_request_timeout_seconds. The five-minute defaults are unchanged. #5321
  • openshell sandbox create --timeout <SECONDS> sets how long the CLI waits for provisioning, overriding the 300-second default and OPENSHELL_PROVISION_TIMEOUT. #5545
  • Shared supervisors now spread evenly across gateway replicas when they connect, and new metrics report supervisors per gateway and the busiest supervisor's sandbox count. Supervisors only move when they reconnect, so placement can stay uneven until they restart. #5436
  • A new openshell.v1.ServiceDiscovery service provides GetServiceRouteSnapshot and WatchServiceRoutes so proxies and controllers can discover a workspace's service routes. #4941
  • Inspected HTTP responses now carry an X-OpenShell-Request-ID header that links them to OCSF records and supervisor traces. The ID is a join key, not proof of authorization or delivery, and L4 or uninspected traffic doesn't get it. #5214
  • Gateway delete records now name the workspace and resource deleted, and show when a delete found nothing to remove or is still in progress. #5609
  • A reusable Grafana monitoring mixin provides dashboards for operational health, operational logs, and OCSF events in Kubernetes deployments. #5415
  • openshell workspace create and openshell workspace get now accept -o/--output table|json|yaml. #4620

Other

  • Clarified the security docs on L7 audit mode, Google token delivery, and what the sandbox runtime protects. #5452
  • Ported sandbox lifecycle, API, and create-upload end-to-end tests to the testkit. #5431, #4606
  • Added CDI device injection test scenarios for Docker and Podman. #4461
  • Added an end-to-end test that checks Kubernetes trace export against Jaeger. #5517
  • Fixed Helm overlay handling in the shared-supervisor HA end-to-end test. #5447
  • Generated the nextest profile from shared timeout constants. #5450
  • Ran the Docker external-driver conformance suite on a dedicated test machine. #5603
  • Added a lint that rejects raw TcpStream::connect calls. #5280
  • Fixed sibling script imports during typechecking. #5490
  • Let in-progress dev releases finish instead of being cancelled. #5633
  • Automatically labeled new PRs for accepted work, recorded acceptance evidence as structured metadata, and showed the cause of Review Readiness failures. #5260, #5579, #5575
  • Extracted issue and PR labeling into its own skill, added independent SDK language reviewer topics, and refined label selection guidance. #5355, #5503, #5516, #5581
  • Added the omit-needless-words review skill. #5498
  • Marked stale triage closures with stable metadata. #5493
  • Documented how to run Z3-linking tests with nix develop. #5512
  • Replaced yanked dependencies in standalone examples and refreshed blocked advisory exceptions. #5533, #5637

Windows packages

Signed portable Windows packages are available for ARM64 and [x64](https://github.com/NVIDIA/OpenShell/releases/download/v0.1.9/OpenShell-Window...

Read more

OpenShell v0.1.8

Choose a tag to compare

@github-actions github-actions released this 10 Nov 18:14
f3d9765

OpenShell v0.1.8

Quick install

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=v0.1.8 sh

Upgrade notes

  • Static provider credentials without placement metadata now resolve only in the Authorization header or through explicitly enabled body/WebSocket rewrite policies, so custom headers such as x-api-key, query parameters, and path slots need an explicit placement declaration. Upgrade the gateway before the supervisor, and update existing imported profiles as needed, since editing reference YAML alone does not update the gateway catalog. auth_style selects the active placement, and fields for other styles are ignored. #4886
  • 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. #5336
  • 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", and other gateway classes use unmapped.sandbox_id and unmapped.sandbox_name. SIEM parsers that read top-level container.uid or container.name must update their mappings. #5048
  • 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. #5278
  • 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". #5101
  • The openshell Python SDK is now published from ai-openshell/sdk-python starting with 0.1.8, and core GitHub Releases no longer attach its wheel or checksum. Keep installing it with pip install openshell from PyPI. #5350
  • The Go SDK module github.com/NVIDIA/OpenShell/sdk/go is deprecated. Switch to github.com/ai-openshell/sdk-go, now developed in ai-openshell/sdk-go. #5245
  • The Go SDK now shares oidc_token.json with the CLI, and v1.RefreshableToken no longer returns an expired cached token after a failed refresh for any token source. Run openshell gateway login once to replace token files written by earlier Go SDK releases. #4830
  • Gateway interceptors can now intercept sandbox start, stop, suspend, and resume RPCs. After you upgrade and restart the gateway, dynamic interceptor registrations that advertise these RPCs can start intercepting them, while strict allowlist or exact registrations need matching operator configuration. #5173

Bug fixes

  • Deleted sandboxes no longer leave memory behind on the gateway, so repeated create/delete cycles no longer grow gateway memory until it is OOM-killed. #5428
  • The gateway no longer pre-allocates about 3.4 MiB of stream buffers for every sandbox. #5408
  • When PostgreSQL is unreachable, gateway requests now fail within about 5 seconds with a retryable UNAVAILABLE error, and a gateway started during the outage becomes ready once the database returns instead of crash-looping. #5244
  • Deleting a sandbox on Kubernetes no longer waits out the pod's 30-second termination grace period. #5279
  • A sandbox no longer exits when its control listener hits a transient accept error such as EMFILE, and DNS over TCP keeps working after a client resets a connection before it is accepted. #5211
  • On Kubernetes, a late status update during a stop no longer flips a stopped sandbox back to Provisioning and blocks the next stop. #5196
  • AWS SigV4 signing diagnostics no longer appear in supervisor TRACE logs, where they could expose the temporary session token. #4558
  • Provider attachment now checks credential inspection against the sandbox's latest saved policy instead of its creation policy. #5310
  • SSH relays and service forwards now have separate per-sandbox connection limits, set with max_ssh_connections_per_sandbox and max_service_connections_per_sandbox in the gateway config (default 20). #5063
  • The CLI now renews expired OIDC client credentials tokens by repeating the grant instead of failing with no refresh token available. Renewal needs OPENSHELL_OIDC_CLIENT_SECRET to be set. #4389
  • openshell sandbox download now works on busybox-based images. #5420
  • openshell policy update --add-endpoint now accepts the allow-encoded-slash option. #4968
  • openshell status --gateway <name> now exits non-zero when the named gateway is not registered. #5379
  • Podman sandbox deletion and create rollback now remove only volumes labeled as owned by that sandbox, and keep any others with a warning. #4714
  • Binary identity resolution now bounds its procfs work per mediated connection, so long command lines and digest-cache churn no longer slow connects without limit. Hashing a large, uncached executable can still delay a connect. #5213
  • Isolation descriptors with an invalid workload identity, such as UID or GID 0 or an empty source or resource digest, now fail to deserialize instead of being accepted. #5192
  • Sandbox signal masks are now built from zero-initialized memory, which fixes reads of uninitialized bytes on 64-bit musl. #5194
  • openshell-gateway config preflight now warns when allow_unauthenticated_users is enabled. #5105
  • The Docker driver now warns at startup when Docker Engine is older than the documented 28.0 minimum. #5369
  • The TUI policy viewer now shows each allowed or denied MCP tool name or pattern instead of tools/call *. #5345
  • The TypeScript SDK now revokes SSH forward tokens when you call forward().close(). #5079
  • The Go SDK now falls back to the system active_gateway when the user one is missing or invalid, matching the CLI. #4917
  • The Go SDK now sets up Listen tunnels in parallel, so one slow setup no longer blocks other clients. #4995
  • The Python SDK adds an opt-in delete_timeout_seconds on Sandbox and a timeout_seconds argument on delete, for Kubernetes pods that take longer than 30 seconds to terminate. #4697
  • The installer no longer prints awk escape warnings while looking up RPM assets. #4845
  • VM runtime tarballs now record the libkrunfw commit, kernel version, and kernel config hash, including on macOS. #4650

Features

  • The metrics listener can now serve /metrics over TLS, with optional mutual TLS, configured through gateway TOML, CLI flags, environment variables, or Helm Secrets. Plaintext remains the default. #3877
  • In multi-replica gateways, shared-supervisor pool sandbox sessions now stay on the gateway replica that serves their supervisor, including across gateway and supervisor failures. #5052
  • Supervisors now advertise the application routes they have installed, so gateways can discover them for both dedicated and shared supervisors. #4940
  • OCSF HTTP and API audit events now correlate with sampled OpenTelemetry traces, and OTLP log records carry trace and span context. More refusal findings are now classified as Denied, which can increase denial-query counts. #4789
  • The CLI now forwards TRACEPARENT and TRACESTATE from its environment to the gateway, so CI pipeline traces parent gateway spans. #2931
  • The Kubernetes driver adds a supervisor_runtime_class_name setting for dedicated supervisor pods. #5349
  • The Helm chart now supports priorityClassName and topologySpreadConstraints for the gateway pod. #2832

Other

  • Documentation now uses "OpenShell" in place of "NVIDIA OpenShell", and the README announces the project's planned move to the CNCF and the ai-openshell organization. #5441
  • Documentation clarifies security boundaries, supervisor recovery, credential rotation, and native inference guidance...
Read more

OpenShell v0.1.7

Choose a tag to compare

@github-actions github-actions released this 03 Nov 19:24
5d25211

OpenShell v0.1.7

Quick install

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=v0.1.7 sh

Upgrade notes

  • Breaking: OpenShell now emits native OCSF 1.8.0 records only, so deployments that relied on 1.1 or 1.3 records now receive 1.8.0. The ocsf_schema_version setting, the gateway schema_version fields, Helm server.ocsfLog.schemaVersion, and OPENSHELL_OTLP_OCSF_SCHEMA_VERSION are deprecated and ignored, and setting them logs a warning. #5036
  • The Podman-only [openshell.drivers.podman].additional_ca_bundle setting from v0.1.5 still works, but it is deprecated in favor of the new [openshell.supervisor.network].additional_ca_bundle. The old key is only honored when Podman is the active compute driver. #5155
  • On the MicroVM driver, sandboxes from registry images and rootfs tars now run as the image's sandbox account, as documented, instead of always running as 1000:1000. New sandboxes from images whose sandbox account isn't UID 1000 now run under that UID, and requesting the image's own UID with run_as_user now works. #5131
  • config preflight and gateway startup now reject an [openshell.gateway.supervisor_pool] table when the selected driver doesn't use shared supervision, and they reject a pool recovery timeout shorter than member failure detection. #4988

Bug fixes

  • Shared-pool sandboxes whose supervisor stays gone past the 60-second recovery deadline now show as Stopped, and sandbox start runs them again. #5076
  • When the shared supervisor pool can't place a sandbox, sandbox create now says why: the pool isn't ready, no replica is attached, no replica has room, or placement failed. #4985
  • VM sandboxes now start when the gateway runs with a restrictive umask, such as the packaged UMask=0077. #5099
  • For direct connections, address selection from policy DNS now goes through the same destination checks as endpoint decisions. #5004
  • The gateway now accepts a supervisor's full 200-line reconnect log backlog instead of silently dropping half of it. #5049
  • OCSF events from the supervisor and gateway now pass validation against the official OCSF 1.8.0 schema. #4288, #5020
  • Vulnerable Rust dependencies are updated, including zip (GHSA-m665-v7pm-7grj), russh and pageant (open Dependabot alerts), and pulldown-cmark, and the unmaintained rustls-pemfile parser is replaced. #5026, #5030, #5122, #5123

Features

  • Kubernetes sandboxes can now update their image, command, environment, and metadata without being recreated or losing persistent storage. Updates require operator activation and a stopped sandbox, and stopping a completed, failed, or timed-out sandbox now moves it to Stopped while keeping its exit code or timeout diagnosis. #4873
  • Sandboxed agents can send OpenTelemetry traces to your collector without an egress rule: add [openshell.gateway.otlp.agent] with enabled = true to gateway.toml, and the supervisor tags each span with the sandbox id before forwarding it. #4276
  • OTLP export can now use OTLP/HTTP: set protocol = "http/protobuf" on [openshell.gateway.otlp] or any of its signal tables, with gRPC remaining the default. An OTLP endpoint that includes a query string is now a configuration error. #5082
  • OTLP collectors that require authentication or routing headers are now supported through headers or headers_file on [openshell.gateway.otlp] or a signal table. Supervisors and the agent trace relay send them too, so MLflow can ingest relayed agent traces directly with x-mlflow-experiment-id. #5083
  • OTLP collectors can use a private CA and mutual TLS: set ca_file, and optionally cert_file and key_file, on [openshell.gateway.otlp] or a signal table. The agent trace relay and OTLP/HTTP export now also support https:// collectors. #5084
  • Sandbox egress can now trust private PKI through [openshell.supervisor.network].additional_ca_bundle, which adds a PEM bundle on top of the default roots for every first-party compute driver. #3292
  • A new opt-in supervisor TLS listener lets declared HTTP and WebSocket sandbox services take application traffic directly, without going through the gateway. It is disabled by default. #4936
  • When several gateways share a Kubernetes cluster, ingress, and wildcard certificate, you can set service_hostname_format = "hashed" under [openshell.gateway] to give each exposed service a unique hostname. The default readable format is unchanged. #4842
  • The Rust, Go, Python, and TypeScript SDKs now send exec calls straight to the gateway replica that owns the sandbox when replica routing is enabled. Go also routes port-forward and SSH tunnel calls this way, and TypeScript routes port-forward. #4790, #4852, #4918, #4877
  • CLI browser login now works when the CLI runs inside a container: set OPENSHELL_CALLBACK_PORT to fix the callback port and OPENSHELL_CALLBACK_BIND_ADDRESS to change the bind address. The defaults are unchanged. #5065
  • The Python gRPC bindings now ship typed sync and async stubs, so editors and type checkers know the concrete request and response types. #5040
  • Embedders can opt into a system-OpenSSL crypto backend; AWS-LC remains the default. #4843

Other

  • The Podman container gateway docs now give a tested mTLS procedure and list every cause of the --tls-cert is required when TLS is enabled startup error. #4977, #5001
  • The service expose example in the docs now uses an image that includes Python. #4197
  • Stable release publication can now be retried safely without overwriting published artifacts, each release publisher can be dispatched on its own, and Release Dev keeps publishing when a snap upload or Go SDK tag fails. #4986, #4987, #5018
  • The temporary v0.1.6 protobuf compatibility exception was removed from release qualification. #4978
  • OCSF tests now validate events against the JSON Schemas exported by the OCSF schema server. #5019
  • The conformance suites moved onto testkit and now run through the new test runner, including on tmachine and in the host E2E lanes. #4773, #4774, #5078
  • Feature tests can now use services started by the test environment, beginning with Keycloak. #4891, #5089
  • E2E fixes: the shared supervisor harness now works with gateway TLS, and kind now gets its Calico images through the runner mirror. #4984, #5178
  • The Gator agent launcher can run on Kubernetes gateways with reusable tooling images, and it now applies manifest settings to the launched sandbox only. #4744, #4888
  • Build fixes: worktree builds no longer rebuild openshell-core every time, Windows lint passes again, and local image builds send a smaller build context. #4947, #5021
  • Dependency updates: OpenTelemetry 0.33 and rustls 0.23.46 in the test and example crates. #5081, #4994, #4996, #4997, #4998
  • Divesh Chowdary (@FrostGod) joined the OpenShell maintainers. #5175

OpenShell v0.1.6

Choose a tag to compare

@github-actions github-actions released this 27 Oct 17:56
ac7f615

OpenShell v0.1.6

Quick install

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=v0.1.6 sh

Upgrade notes

  • 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]. #4821
  • New sandboxes on Kubernetes, Docker, Podman, and VM now open the control connection from the sandbox to its supervisor, while running sandboxes keep their existing connection direction. Upgrade the supervisor and sandbox runtime binaries together, because older binaries reject the new sandboxes. #4656
  • You can now suspend and resume sandboxes with openshell sandbox suspend and openshell sandbox resume or through the SDKs, on compute drivers that support it; other drivers return an unimplemented error. External isolation backends need to know that ResumeBoundaryRequest field 3 is renamed from allow_cold_start_fallback to restart_if_restore_fails. #4765

Bug fixes

  • The Python SDK now ships the credential driver and extension protocol bindings, so you can write credential drivers in Python. #4760
  • The Go SDK now accepts gateway names derived from FQDNs and IPv4 addresses, as the CLI creates them, and still rejects names that aren't safe as Windows filenames. #4767
  • A busy sandbox no longer stalls lifecycle operations on unrelated sandboxes while the gateway checks provisioning deadlines. #4549
  • VM sandboxes boot digest-pinned images straight from the local cache without contacting the registry, so they start faster and still boot when the registry is unreachable. #4582
  • VM sandboxes built from images with a missing or empty /etc/hosts now resolve localhost. #4182
  • The Podman driver now waits up to 60 seconds instead of 30 for API calls, which reduces timeouts during sandbox creation. #4820
  • install.sh now finds the gateway config directory under XDG_CONFIG_HOME the same way the CLI does, so local gateway setup no longer times out when that variable is set. #4063
  • The snap now provides the openshell-prover command like other packages, replacing openshell.prover. #4835
  • Updated webpki to stop trusting the compromised emSign certificate authorities (CVE-2026-111943). #4794
  • Updated russh to 0.64.1 to fix GHSA-4wc5-f2rc-q74m (CVE-2026-111061). #4742
  • Updated Tokio and crypto-bigint to fix RUSTSEC-2026-0386 and RUSTSEC-2026-0387. #4924
  • Updated ctutils to fix the RUSTSEC-2026-0385 timing advisory. #4867
  • The multi-agent shared-notepad example now launches on the current CLI. #4807

Features

  • Kubernetes gateways can run an experimental shared supervisor that hosts many sandboxes in one process. Enable it with supervisor_topology = "gateway" under [openshell.drivers.kubernetes] (gateway TLS is required), and on OpenShift use supervisor.podSecurityContext so restricted-v2 can assign the IDs. #4695, #4701, #4702, #4785
  • Experimental shared supervisors always run as a pool that can take over a failed supervisor's sandboxes; set supervisor.replicas to change capacity, and note that one replica has no spare for immediate failover. During takeover, workloads can briefly freeze, existing proxied connections and interactive sessions must reconnect, and workloads terminate if supervision isn't restored within the recovery deadline. #4864
  • The gateway now writes OCSF audit events for authorization denials, accepted credentials, SSH session tokens, and sandbox token checks, and raises a High-severity finding when a sandbox credential looks misused. Callers see the same errors as before. #4728, #4761, #4762
  • Operators can require a middleware service to provide specific bindings, such as request inspection, by setting binding_policy to allowlist or exact. Upgrade supervisors before you rely on it, because older supervisors don't enforce it. #4678
  • Prerelease builds now publish to the snap's latest/beta channel, and OPENSHELL_VERSION=pre install.sh installs the snap from there. #4870
  • The Helm chart adds server.extraEnv for passing extra environment variables, including Secret references, to the gateway container. #4876
  • The Helm chart adds pkiInitJob.podLabels and pkiInitJob.podAnnotations for the certificate hook pods. #4895
  • Stable releases now tag the Go SDK module as sdk/go/vX.Y.Z, so Go tooling and pkg.go.dev show real versions. #4262

Other

  • The Docker supervisor healthcheck now runs every 30 seconds once the sandbox is ready, rather than every 250 ms. #4802
  • The CLI now connects to gateways through the shared Rust SDK transport. #4817
  • Native Windows documentation now identifies windows as its implementation and release branch and explains the current build and runtime limitations. #4758
  • Added a guide for connecting an external compute driver to a gateway. #4826
  • Added a security policy that uses GitHub private vulnerability reporting, with a report template and advisory authoring workflows. #4832, #4872
  • sandbox create --upload help and docs now say it can't take a trailing command; use sandbox exec instead. #4502
  • Updated workload image docs: images no longer need iproute2 or nftables, and images without USER run as UID/GID 1000 on Docker and Podman. #3967
  • Fixed the OpenRouter provider smoke test so it prints a result. #3907
  • Added RFC 0018 on multi-sandbox and highly available supervisors. #4377
  • Removed the obsolete privileged SCC grant from the OpenShift e2e setup. #4823
  • Native gateway builds on macOS raise the open-file limit to avoid "Too many open files" errors. #3122
  • Added the testkit library for SDK-driven end-to-end tests. #4724
  • Moved tmachine support files under tests/tmachine. #4726
  • Consolidated gateway audit helpers and test fixtures. #4777, #4778
  • Repaired the Windows MSVC test suite. #4862
  • Fixed a flaky CLI port-forward test. #4799
  • Removed the unused openshell-server-macros crate. #4818
  • Added a release-captain skill for the weekly release cadence. #4435
  • Release and Pre-release workflows can now infer their tags from the branch. #4707
  • Stable releases reuse the release notes previewed on the promoted prerelease. #4754
  • Allowed the accepted protobuf compatibility breaks for v0.1.6 prerelease qualification. #4976
  • The compatibility review now checks executable flags that external compute drivers use. #4644
  • Switched the compatibility review to GPT-6.1 Sol. #4796
  • Kept Rust CI caches warm on main and stopped saving binary caches from branches. #4881
  • Updated the rust-cache action. #4748
  • Updated the setup-buildx action to v4.4.1. #4741
  • Added cargo-deny exceptions for zstd advisories that don't affect current usage. #4973
  • Updated setuptools and Vitest to patched releases. #4969
  • Updated Vite in the TypeScript SDK to 8.1.6. #4792
  • Updated certifi to 2026.10.19. #4764
  • Updated Mermaid lint dependencies. [#4743](https://github.com/NVI...
Read more

OpenShell v0.1.5

Choose a tag to compare

@github-actions github-actions released this 20 Oct 17:28
bdb956f

OpenShell v0.1.5

Quick install

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=v0.1.5 sh

Upgrade notes

  • Supervisor OCSF log files are now named openshell-ocsf.YYYY-MM-DD.jsonl instead of .log, so update any collector patterns from openshell-ocsf.*.log to openshell-ocsf.*.jsonl. Old .log files are not migrated and may be cleaned up, so collect any history you need before upgrading. #4263
  • On Kubernetes, sandbox templates that set pod annotations or labels are now rejected unless an operator allowlists those keys with the new allowed_pod_annotations and allowed_pod_labels settings in [openshell.drivers.kubernetes]. This affects direct API or SDK callers that set SandboxTemplate.labels or SandboxTemplate.annotations, including recovery of timed-out sandboxes; the openshell CLI and --label metadata labels are unaffected. #4497
  • The gateway now rejects annotation keys with the reserved internal.openshell.ai/ prefix on CreateSandbox and UpdateConfig. #4626
  • The Go SDK's SandboxInterface.Create() and CreateFromTemplate() now take functional options such as WithLabels(), WithAnnotations(), and WithServiceExposures() instead of a positional labels argument and the removed CreateOptions struct. Update call sites to the new options. #3198
  • External compute drivers that provision openshell-sandbox must update their bootstrap descriptor from outer_fence to provisioning_evidence; drivers that use their own isolation backend are unaffected. This release also publishes the versioned Sandbox Protocol for independently implemented backends. #3898
  • The snap no longer enables the user gateway service for every user; the install script enables it only for the user who ran it. After a direct snap install, or if an older snap revision enabled it globally, run sudo systemctl disable --global snap.openshell.user-gateway.service once and then systemctl --user enable --now snap.openshell.user-gateway.service from the single account that should run the gateway. #4615

Bug fixes

  • Hostname-based network policy is now bound to supervisor-controlled DNS, while sandbox host aliases still require explicit IP validation or a trusted gateway pin. #4602
  • Stopping a MicroVM sandbox no longer discards recent writes, because the guest now flushes its filesystem before shutdown. #4195
  • You can now stop a sandbox stuck in Error after a startup failure and start it again, without deleting it or its persistent workspace. #4231
  • OTLP export with gzip compression or an https:// endpoint no longer fails at startup. #4399
  • Podman deployments can trust a private CA for inspected HTTPS egress with the new additional_ca_bundle setting, without rebuilding the supervisor image. The CA is trusted for all destinations by both the supervisor and the workload. #3996
  • The Helm chart now installs in namespaces that enforce the Restricted Pod Security standard, and the certgen hook security context can be overridden with pkiInitJob.securityContext. #3340
  • GitHub App OAuth token refresh now works, because the gateway asks for a JSON response. #4530
  • A deleted provider that sandboxes still reference no longer blocks gateway startup; the gateway logs a warning instead. #4661
  • In Kubernetes operator workspace mode, labeled workspaces are no longer rejected with PermissionDenied right after gateway startup. #4527
  • Kubernetes PVC mounts can no longer overlap driver-managed runtime and control paths. #4522
  • The sandbox network broker now denies operations when it cannot verify a descriptor, instead of falling back to native handling. #4494
  • VM guest startup is hardened so the packaged sandbox keeps its expected executable identity. #4539
  • Seccomp notification probe failures now report the actual kernel error instead of a generic "notification launcher disappeared" message. #4051
  • e2fsprogs preflight checks no longer fail when Linux briefly reports a newly installed executable as busy. #4315
  • Middleware now sees http and ws for plaintext requests in a tunnel instead of https and wss. #4397
  • L7 OCSF HTTP events now report https for TLS-terminated requests. #4684
  • OCSF events now include the required device.os.type_id, so they validate against the OCSF 1.8 schema. #4677
  • Mutation-lock metrics from the gateway's startup reconciliation are no longer dropped. #4524
  • Updated rustls to 0.23.46 to address RUSTSEC-2026-0346 through RUSTSEC-2026-0349. #4568
  • The RPM-installed Python SDK now imports correctly, and its stubs can be generated with older protoc versions. #4439
  • Builds now honor the PROTOC environment variable, so distribution builds can use their system protobuf compiler. #4441

Features

  • Supervisors can now receive configuration changes pushed over their gateway session by setting config_delivery_mode = "push", so policy and setting changes reach sandboxes in about 100 ms instead of up to 10 seconds. Polling remains the default in this release. #4320
  • The gateway and sandbox supervisors can export OCSF events as OTLP log records when [openshell.gateway.otlp.ocsf] sets enabled = true, and you can now send traces and OCSF events to different OTLP endpoints. Existing configurations with only [openshell.gateway.otlp] endpoint behave as before. #4500, #4545
  • The gateway now emits OCSF Authentication events for rejected requests, including the authentication mechanism, a reason category, the peer address, and the request ID. #4632, #4655, #4673
  • MicroVM sandboxes can mount host directories through virtiofs after an operator sets enable_bind_mounts = true in [openshell.drivers.vm]. You can use up to 3 mounts on x86_64 or 32 on aarch64, and QEMU-backed and GPU launches do not support mounts. #3463
  • The Docker supervisor can now use bridge networking with the new supervisor_network_mode setting; host networking remains the default. #4016
  • openshell sandbox create now accepts repeatable --annotation KEY=VALUE flags. #4325
  • openshell sandbox create adds --env-from KEY[=ENVVAR] to set sandbox environment variables from the CLI's environment without putting values on the command line. The OPENSHELL_OCSF_JSON=1 gateway audit sink is also now available on all platforms. #4106
  • When a dynamic token grant is refused, sandbox reads now show a bounded cause and recovery action, while the workload gets an HTTP 502 with an x-openshell-request-id it can share. #4427
  • The Helm chart adds server.dataStorageSize and server.dataStorageClass to configure the gateway data PVC. #3854
  • Gateway mutation locks are now scoped per workspace and sandbox, with bounded waits, so bursts of supervisor reconnects no longer queue behind a single fleet-wide lock. #4147

Other

  • Added documentation for the Port Forwarding IPv6 loopback example, sandbox create size limits, Kubernetes managed workspace setup, and new Observability overview and Traces pages. #2449, #4447, #4622, #4560
  • Removed the grpcurl walkthrough from the README. #4585
  • Added an RFC that proposes a sandbox service exposure architecture. #4267
  • Introduced a backend-neutral cryptography interface while keeping AWS-LC as the production backend and preserving existing credential formats and TLS defaults. #3351
  • The CLI and gateway no longer link ring alongside AWS-LC. #4468
  • Sped up gateway server builds by removing async_trait from internal traits. #4619
  • Updated development and build dependencies, including setuptools, pytest, TypeScript SDK tes...
Read more

OpenShell v0.1.4

Choose a tag to compare

@github-actions github-actions released this 13 Oct 20:48
5a7728c

OpenShell v0.1.4

Quick install

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=v0.1.4 sh

What's Changed

  • feat(snap): run gateway as a user service by default by @olivercalder in #4099
  • chore(test-guest): remove snap reproduction helper by @elezar in #4368
  • fix(ci): publish merge queue E2E statuses by @elezar in #4370
  • chore(deps): bump mermaid from 11.16.0 to 11.16.1 in /scripts/lint-mermaid by @dependabot[bot] in #4369
  • feat(server): add operator-only provider credential retrieval by @sjenning in #4357
  • feat(ci): gate merges on maintainer approval via a required status check by @purp in #3176
  • test(tmachine): use K3s ClusterIP, wait for gateway, add failure diagnostics by @matthewgrossman in #4258
  • fix(core): resolve credential aliases after revision eviction by @stevenlee-oai in #4390
  • refactor(runtime): confine and reduce unsafe code by @drew in #4130
  • fix(cli): name the sandbox in service not-found errors by @ericcurtin in #3798
  • feat(gateway): add gRPC server reflection by @2000krysztof in #3161
  • test(conformance): run driver suites with cargo by @elezar in #3866
  • feat(providers): support stable credential placeholders by @shiju-nv in #3339
  • fix(gator): surface PR-owned security regressions in reviews by @johntmyers in #4338
  • feat(sdk/ts): add createdAtMs to SandboxRef by @ericcurtin in #4347
  • fix(server): retry stop lifecycle writes after concurrent updates by @pimlock in #4395
  • fix(docs): use lowercase "snap" as it is not a proper noun by @olivercalder in #4387
  • feat(python): expose sandbox status conditions in the SDK by @maxdubrinsky in #4436
  • fix(python): close client when Sandbox entry fails by @ericcurtin in #4367
  • fix(network): enforce consistent HTTP framing by @alangou in #4414
  • docs: clarify vouch timing, DCO vs signing, Cargo feature conventions by @politerealism in #2810
  • fix(sandbox): name Landlock ABI in startup error by @ericcurtin in #4413
  • fix(server): return SQLite write versions atomically by @ericcurtin in #4408
  • fix(cli): disable ssh connection sharing for sandbox sessions by @ericcurtin in #4157
  • fix(cli): preserve external TLS for SSH forwarding by @danehans in #4344
  • fix(kubernetes): refresh sandbox runtime image on start by @lunarwhite in #4376
  • docs(runtimes): show required schema version in gateway TOML examples by @fede-kamel in #3910
  • docs(extensibility): name extension base capabilities by @ericcurtin in #4405
  • test(tmachine): add a K3s HA conformance lane with PostgreSQL and mTLS by @matthewgrossman in #4081
  • chore(ci): close stale issues after 14 additional days by @purp in #3985
  • chore(codeowners): disable wildcard ownership rule by @purp in #3168
  • test(vm): avoid inherited lease race in restart cleanup test by @grs in #4316
  • fix(windows): restore MSVC lint for CLI and MXC by @feloy in #4194
  • chore(deps): bump astral-sh/setup-uv from 10.0.0 to 10.0.1 by @dependabot[bot] in #2767
  • feat(sdk-ts): add watchLogs with loss-aware resume by @letv1nnn in #3778
  • fix(server): audit proposal rejections in the gateway by @ericcurtin in #4281
  • test(e2e): remove stale policy retries by @TaylorMutch in #4453
  • ci: require accepted issues for community pull requests by @elezar in #4340
  • refactor(vm): source runtime pins only from pins.env by @benoitf in #4373
  • fix(release): qualify prerelease tag pushes by @SDAChess in #4335
  • test(oci): add a shared Docker and Podman suite for image USER and WORKDIR by @matthewgrossman in #3931
  • fix(kubernetes): time out kube requests per request instead of per idle connection by @matthewgrossman in #4452
  • fix(prover): distinguish sibling endpoints and fail closed on solver errors by @alangou in #4326
  • fix(vm): bind cached registry images to verified manifest digests by @alangou in #4342
  • test(podman): run the e2e binaries that pass in the tmachine guest by @politerealism in #4422
  • refactor(prover): remove legacy unused reachability constraints by @eviehoward in #2441
  • fix(cli): backpressure sandbox uploads by @shiju-nv in #4448
  • ci(security): temporarily remove Codex from release scans by @alangou in #4469
  • fix(sandbox): release broker-owned listening sockets by @johntmyers in #4444
  • feat(providers): add CLI label creation and filtering by @johntmyers in #4265
  • refactor(prover): separate outcome evaluation from rendering by @eviehoward in #2632
  • fix(sdk-ts): preserve rpc errors for out-of-range responses by @SDAChess in #4495
  • ci(compatibility): review PR breaks and acknowledge release risks by @SDAChess in #4488
  • fix(ci): skip maintainer approval in merge queue by @purp in #4496

New Contributors

Full Changelog: v0.1.3...v0.1.4

OpenShell v0.1.3

Choose a tag to compare

@github-actions github-actions released this 09 Oct 15:22
e1f3c82

OpenShell v0.1.3

Quick install

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=v0.1.3 sh

What's Changed

  • feat(helm): make cluster-scoped RBAC optional by @ansjindal in #3459
  • fix(supervisor): keep session retries during startup by @drew in #3765
  • fix(e2e): reserve distinct corporate proxy fixture ports by @drew in #3761
  • test(cli): migrate gateway-free smoke coverage by @elezar in #3641
  • test(conformance): migrate file transfer coverage by @elezar in #3597
  • fix(server): retry provider attachment CAS conflicts by @drew in #3501
  • test(e2e): run podman suite with tmachine by @elezar in #3637
  • fix(network): refuse protocol upgrades on JSON-RPC and MCP endpoints by @shiju-nv in #3753
  • feat(cli): detach sandbox sessions with Ctrl-D by @drew in #3744
  • fix(cli): prevent orphaned SSH forward muxes by @drew in #3759
  • test(install): support Bash 3.2 mock capture by @elezar in #3790
  • feat(mcp): inspect requests with Tower-selected protocol profiles by @shiju-nv in #3335
  • feat(sandbox): add main restart policy by @drew in #2798
  • perf(kubernetes): use a TCP readiness probe for the supervisor by @FrostGod in #3700
  • feat(docker): support corporate proxy CA bundles by @feloy in #3549
  • fix(e2e): stop sandbox leaks from async Drop cleanup by @ericcurtin in #3750
  • fix(cli): keep policy and provider diagnostics readable by @shiju-nv in #3444
  • feat(server): write gateway OCSF events to JSONL by @krishicks in #3264
  • test(sandbox): bind ephemeral port in accepted loopback stream test by @krishicks in #3872
  • fix(network): preserve pipelined requests after chunked inspection by @shiju-nv in #3861
  • docs: remove the architecture directory by @krishicks in #3799
  • fix(ci): restore repository permission vetters by @pimlock in #3875
  • feat(helm): configure gateway OCSF JSONL output by @krishicks in #3876
  • fix(supervisor): restore canonical stdin after connection loss by @shiju-nv in #3852
  • fix(mcp): explain revision-scoped policy and rejections by @shiju-nv in #3850
  • feat(providers): add Oracle Cloud Infrastructure Generative AI provider profile by @fede-kamel in #3904
  • feat(providers): serve sandbox config files on demand by @drew in #3832
  • fix(policy): validate raw OPA settings and redact startup errors by @shiju-nv in #3788
  • Fix/startup provider readiness by @ebusto in #3819
  • test(podman): move podman_preflight into driver-podman integration tests by @politerealism in #3783
  • fix(conformance): require successful list to certify deletion by @elezar in #3792
  • test(tmachine): add K3s conformance scenario by @SDAChess in #3848
  • perf(otel): stop exporting spans from steady-state polling by @krishicks in #3915
  • fix(cli): accept sandbox name before -- in exec by @ericcurtin in #3901
  • fix(network): refuse protocol upgrades on GraphQL endpoints by @shiju-nv in #3841
  • feat(service): add bearer authorization passthrough by @derekwaynecarr in #3796
  • fix(server): log polled request responses at debug by @krishicks in #3974
  • refactor(sandbox): remove unreachable root-side identity and workspace code by @matthewgrossman in #3979
  • fix(e2e): keep locally built Kubernetes images off the chart's default registry by @krishicks in #3991
  • fix(gator): require full head SHA for /ok to test by @purp in #4007
  • fix(gateway): delete finalized ephemeral sandboxes while connected by @johntmyers in #3984
  • refactor(auth): separate sandbox identity from TLS by @drew in #3110
  • chore(build): remove bundled Z3 support by @SDAChess in #3275
  • fix(runtime): recover SSH relays and bound startup diagnostics by @drew in #4011
  • fix(ci): align integration inputs with release candidate source by @SDAChess in #4048
  • test(e2e): remove schema parity campaign by @elezar in #3864
  • fix(ci): qualify protobuf compatibility by release train by @SDAChess in #4049
  • feat(flake): Add missing packages to flake for running mise commands by @bornav in #2151
  • test(tmachine): add Fedora RPM package installer by @elezar in #4025
  • ci: use package installers consistently in integration tests by @elezar in #4056
  • fix(snap): simplify snap hooks by @olivercalder in #3988
  • fix(supervisor): wait for repair when the gateway refuses a startup policy write by @shiju-nv in #3785
  • fix(cli): start sandbox exec without waiting for piped stdin EOF by @fede-kamel in #4006
  • chore(agents): simplify contributor instructions and workflows by @johntmyers in #3987
  • fix(supervisor): bound pending exec stdin and cancel stalled writers by @shiju-nv in #3846
  • fix(policy): refresh pending proposals when the sandbox policy changes by @fede-kamel in #3923
  • feat(sandbox): write agent output to the container log by @krishicks in #4005
  • chore(gator): default to GPT-6.1 Sol by @johntmyers in #4065
  • feat(examples): run Jupyter notebooks in an OpenShell sandbox by @drew in #2253
  • test(python): synchronize interactive exec TTY readiness by @matthewgrossman in #4076
  • fix(sandbox): restrict provider file mode by @drew in #4093
  • fix(ci): retry Nix shell and app dependency preparation by @matthewgrossman in #4066
  • feat(snap): ship the standalone prover binary in the snap by @olivercalder in #3717
  • fix(kubernetes): serialize lifecycle cleanup with sandbox restart by @matthewgrossman in #4078
  • fix(deps): upgrade russh to address Dependabot alert 40 by @alangou in #4116
  • fix(cli)!: stop uploads when Git filtering fails or selects no files by @alangou in #3957
  • fix(providers): restore supervisor-backed GCP metadata discovery by @feloy in #3973
  • feat(helm): add sandbox UID and GID values by @ericcurtin in #3947
  • ci(vm): codesign macOS driver-vm with hypervisor entitlement in CI by @benoitf in #3507
  • ci: pin CI images by digest and add native architecture smoke checks by @alangou in #4114
  • fix(providers): stabilize provider environment revisions by @drew in #4122
  • fix(deps): upgrade ratatui to resolve lru vulnerability by @alangou in #4131
  • fix(sandbox): replace lifetime exec cap with retry deadlines by @drew in #4105
  • fix(cli): check final exec status and warn on partial input by @shiju-nv in #3803
  • fix(install): stop waiting when the gateway service fails by @ericcurtin in #4143
  • fix(docker): pull only :latest for a tagless --from, not every tag by @udsy19 in #4124
  • fix(vm): reject conflicting workload identity selectors by @shiju-nv in #4036
  • fix(vm): reclaim cancelled image preparation after worker exit by @shiju-nv in #4039
  • feat(gateway): check VM host tools during config preflight by @shiju-nv in #4037
  • fix(relay): close outbound relay stream when target closes first by @ericcurtin in #3772
  • fix(tui): preserve quoted post-create command arguments by @thotashashank302 in #4137
  • fix(gateway): give image prep...
Read more

OpenShell v0.1.2

Choose a tag to compare

@github-actions github-actions released this 28 Sep 03:58
6648bd0

OpenShell v0.1.2

Quick install

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=v0.1.2 sh

What's Changed

  • docs(policy): clarify sandbox-local loopback access by @drew in #3740
  • docs: refresh architecture and extensibility pages by @drew in #3741
  • fix(supervisor-network): keep workload bytes read with a mediated CONNECT header by @dims in #3745
  • fix(homebrew): overwrite generated gateway config during migration by @drew in #3752
  • fix(ci): keep snap canary sandbox name within limit by @drew in #3751
  • fix(docs): sync redirects with versioned snapshots by @johnnygreco in #3754
  • docs: keep page URLs aligned with file paths by @johnnygreco in #3713
  • perf(sandbox): wake orphan reaper on child exit by @drew in #3757

Full Changelog: v0.1.1...v0.1.2

OpenShell v0.1.1

Choose a tag to compare

@github-actions github-actions released this 26 Sep 03:45
4ce767f

OpenShell v0.1.1

Quick install

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | OPENSHELL_VERSION=v0.1.1 sh

What's Changed

  • fix(gateway): make the WebSocket tunnel opt-in by @drew in #3727
  • test(binary-identity): stabilize procfs identity fixtures by @grs in #3708
  • docs(tutorials): run Pi with OpenRouter by @johnnygreco in #3722
  • fix(snap): require mTLS for the snap gateway by @drew in #3726
  • docs: describe 0.1 series in release callouts by @drew in #3732

Full Changelog: v0.1.0...v0.1.1