OpenShell changelog: what's new each month
Every stable OpenShell release summarised by month: the highlights, new features, improvements, fixes and anything you need to act on. 8 months covered; the current month updates daily.
November 2026 · so far
2 releases: 0.1.7 → 0.1.8
November brought significant updates to OpenShell's standards compliance and security posture. The month focused on upgrading to OCSF 1.8.0 records, improving sandbox placement visibility, and tightening credential and protocol handling.
- OpenShell now emits only OCSF 1.8.0 records; deployments using 1.1 or 1.3 records will receive 1.8.0 instead.
- Sandboxes fail to launch if filesystem policy paths contain symlinks inside writable workspaces; use the symlink's target path in policies instead.
- Transparent TCP endpoint rules must use IPv4 addresses directly instead of IPv4-mapped IPv6 format (change ::ffff:203.0.113.7 to 203.0.113.7).
- The Go SDK module github.com/NVIDIA/OpenShell/sdk/go is deprecated; switch to github.com/ai-openshell/sdk-go.
Highlights
- OpenShell now exclusively emits OCSF 1.8.0 records, replacing support for older versions.
- Sandboxes now fail to launch if filesystem policy paths go through symlinks in writable workspaces, closing a potential security gap.
- Shared supervisor pool sandboxes that exceed the recovery deadline now show as Stopped and can be restarted.
- When shared pool sandbox placement fails, the system now explains why: pool not ready, no replica attached, no replica has room, or placement failed.
- REST endpoints now reject HTTP upgrade requests in both enforce and audit modes, with WebSocket traffic requiring explicit configuration.
New
- MicroVM sandboxes from registry images and rootfs tars now run as the image's sandbox account instead of always using 1000:1000.
- VM sandboxes now start correctly when the gateway runs with restrictive umask settings like UMask=0077.
- For direct connections, address selection from policy DNS now uses the same destination checks as endpoint decisions.
- Transparent TCP connections now properly evaluate IPv4-mapped IPv6 destinations as IPv4 addresses.
- The Go SDK now shares oidc_token.json with the CLI for consistent token management.
Improved
- Config preflight and gateway startup now validate supervisor pool configuration against the selected driver.
- Static provider credentials without placement metadata now resolve only in the Authorization header or through explicitly enabled body/WebSocket rewrite policies.
- OCSF sandbox attribution changed: supervisor events use device.container.uid and device.container.name, while gateway API events use resources entries with type sandbox.
- Go SDK RefreshableToken no longer returns expired cached tokens after a failed refresh from any token source.
Fixed
- Pool recovery timeout configuration is now properly validated during startup.
- Sandboxes in shared supervisor pools that exceed the 60-second recovery deadline are now correctly marked as Stopped.
October 2026
4 releases: 0.1.3 → 0.1.6
October brought significant improvements to sandbox lifecycle management, authentication, and SDK functionality. The month included breaking changes to configuration formats, SDK APIs, and Kubernetes settings that require user attention.
- Supervisor OCSF log file naming changed from openshell-ocsf.*.log to openshell-ocsf.YYYY-MM-DD.jsonl; update collector patterns accordingly.
- Kubernetes pod annotations and labels in sandbox templates now rejected unless operator allowlists keys with allowed_pod_annotations and allowed_pod_labels settings.
- Gateway rejects annotation keys with reserved internal.openshell.ai/ prefix on CreateSandbox and UpdateConfig.
- Go SDK SandboxInterface.Create() and CreateFromTemplate() now require functional options (WithLabels, WithAnnotations, WithServiceExposures) instead of positional labels parameter.
Highlights
- Suspend and resume functionality now available for sandboxes on supported compute drivers.
- Go and Python SDKs enhanced with better gateway name handling and new credential driver support.
- VM sandboxes now boot faster from cached digest-pinned images without registry contact.
- Kubernetes sandbox templates can now control pod annotations and labels with operator allowlisting.
- Gateway authentication hardened to require OIDC, mTLS, or JWT configuration at startup.
New
- Suspend and resume operations for sandboxes via CLI and SDKs.
- Python SDK now includes credential driver and extension protocol bindings.
- Operator-only provider credential retrieval capability on servers.
- Allowed pod annotations and labels configuration for Kubernetes sandbox templates.
- VM sandboxes can now resolve localhost from images with missing /etc/hosts.
- Control connection from sandbox to supervisor on new sandboxes across Kubernetes, Docker, Podman, and VM.
Improved
- Cluster-scoped RBAC is now optional in Helm deployments.
- Go SDK gateway names now accept FQDNs and IPv4 addresses matching CLI behavior.
- VM sandboxes boot digest-pinned images directly from local cache without registry contact.
- Busy sandboxes no longer stall lifecycle operations on unrelated sandboxes during provisioning checks.
- Hostname-based network policy now bound to supervisor-controlled DNS with explicit validation.
- MicroVM sandboxes flush filesystem before shutdown to preserve recent writes.
Fixed
- Session retries maintained during supervisor startup.
- Provider attachment CAS conflicts now properly retried on servers.
- Protocol upgrades refused on JSON-RPC and MCP endpoints.
- Credential aliases resolved after revision eviction.
- CI merge queue E2E statuses now published correctly.
September 2026
3 releases: 0.1.0 → 0.1.2
September brought the initial 0.1 release series for OpenShell, focusing on stability improvements and security hardening. The month included fixes for critical compute and networking issues alongside new configuration options for sandbox execution.
- Daily minor release automatic workflow has been removed; releases now require manual triggering.
Highlights
- Added --no-login-shell flag to skip shell startup files during sandbox execution.
- Made WebSocket tunneling opt-in for improved security by default.
- Recovered Error-phase sandboxes automatically on gateway startup.
- Fixed compute driver watches in Kubernetes environments.
- Enforced mTLS requirement for the snap gateway distribution.
New
- --no-login-shell option for exec to skip shell initialization files.
Improved
- WebSocket tunnel now requires explicit opt-in rather than being enabled by default.
- Sandbox-local loopback access handling clarified and improved.
- Performance enhancement to orphan reaper wake-up mechanism on child exit.
- Workload bytes read now properly tracked with mediated CONNECT header in supervisor network.
- Homebrew installation now correctly overwrites generated gateway config during migration.
- Snap canary sandbox naming kept within system limits.
Fixed
- Kubernetes compute driver watches now recover properly.
- CLI provider identity metadata now included for interceptors on update.
- Sandbox main processes complete successfully when exiting.
- Error-phase sandboxes recover on gateway startup.
- Snap gateway now enforces mTLS requirement.
- VM runtime embedding inputs preserved in CI.
August 2026
15 releases: 0.0.97 → 0.0.116
August brought significant infrastructure improvements and SDK expansions, with new policy features, trace export capabilities across drivers, and Windows support. The month also included dependency audits, credential handling hardening, and the removal of Bazel build support.
- Bazel build support has been removed; use alternative build methods
Highlights
- Added Go and TypeScript SDKs for building with OpenShell
- Implemented policy-based DNS and transparent TCP egress for Docker, Podman, and Kubernetes
- Added Windows compilation support and native Windows MXC compute driver
- Extended driver trace export over OTLP to Podman, Docker, and Kubernetes
- Improved credential security with driver-based storage and stable refresh handles
New
- Stop and start operations for sandboxes
- OIDC device authorization grant for headless login
- Non-root sandbox identities support in policy
- System CA root mode for builds
- Policy DNS correlation store and direct TCP egress foundation
- Helm cert-manager external issuer and OpenShift passthrough Route support
- AI inference event emission via OCSF aioperation profile
- Canonical main process for sandboxes
Improved
- Sandbox startup now honors OCI image working directories
- Credential binding to provider endpoints with static credentials
- TCP performance improved with TCPNODELAY on latency-sensitive hops
- Supervisor middleware performance improved by removing body clones from local dispatch
- Native policy input parsing optimized to avoid reparsing
- CLI now warns when environment values look like credentials
- Gateway interceptor gRPC channel configured with connect timeout and HTTP/2 keepalive
- Podman loopback listeners now properly separated in end-to-end and development scenarios
Fixed
- Sandbox policy revisions now correctly acknowledge unchanged states
- Policy no longer allows implicit authorization inheritance
- HTTPS interceptor endpoints now apply TLS native roots
- CLI prompts for fresh OIDC login after logout
- Trailing-dot CONNECT hosts normalized before policy evaluation
- Supervisor now logs unmatched L7 route denials for better debugging
July 2026
17 releases: 0.0.74 → 0.0.96
July brought expanded agent capabilities, improved security handling, and better support for container orchestration platforms. The month focused on Kubernetes topology options, policy refinements, and stability fixes across drivers.
- Removed deprecated --keep flag from CLI, scripts, and e2e tests.
- Removed openshell policy prove command.
Highlights
- Added manifest-driven gator agent for automated issue triage workflows.
- Introduced combined topology config surface and sidecar supervisor topology for Kubernetes deployments.
- Removed openshell policy prove command and z3 dependency to simplify the CLI.
- Added SELinux label support for bind mounts in Docker and Podman.
- Extended credential handling with AWS STS AssumeRole refresh and improved GitHub provider access.
New
- TLS termination for Envoy Gateway ingress in Helm charts.
- SELinux label support for bind mounts on Docker and Podman.
- Numeric UID support for sandbox process identity policies.
- Sidecar supervisor topology option for Kubernetes.
- Corporate HTTP proxy routing for sandbox egress.
- JSON and YAML output formats for sandbox CLI commands.
- AWS STS AssumeRole refresh strategy and aws-s3 profile support.
- Merge queue feature for CI workflows.
Improved
- Namespace-aware SANs generation in certgen and cert-manager templates.
- Gateway supervisor image tag now pinned to gateway version across all drivers.
- TUI navigation panels now respond to Up/Down arrow key overflow at list boundaries.
- Policy logs now include tool names for better auditability.
- Docker socket probing added during driver auto-detection.
- Sandbox labels now persist on creation.
- Gateway authentication status reporting.
- Minimum Python support lowered to 3.11.
Fixed
- Sandbox JWTs now delivered as secrets in Podman driver.
- TUI warning logs now route to status bar instead of stderr.
- Cross-device rename issues in certgen temp directory handling.
- TTY flag now honored for interactive exec in gateway.
- OPA deny reasons now included in CONNECT 403 proxy responses.
- Read-only mounts now skipped during recursive chown of /sandbox directory.
June 2026
18 releases: 0.0.53 → 0.0.73
June brought substantial infrastructure improvements and new provider integrations to OpenShell. The month focused on stability, multi-cloud support, and enhanced security controls across sandboxes and gateways.
Highlights
- Added Google Vertex AI and DeepInfra as built-in inference providers, plus AWS Bedrock and GCE metadata emulation support.
- Introduced TLS certificate hot-reload and reconciler leases for high-availability multi-replica gateway deployments.
- Added GPU count requests, environment variable passthrough to sandboxes, and out-of-tree compute driver support via socket.
- Enhanced security with L7 policy enforcement for JSON-RPC and MCP, plus AWS SigV4 credential signing for CONNECT tunnels.
- Improved Kubernetes support with apparmor profiles, image pull secrets, runtime class configuration, and agent-sandbox v1beta1.
New
- Google Vertex AI inference provider integration.
- DeepInfra as a built-in inference provider.
- GCE metadata emulator for Google Cloud environments.
- AWS Bedrock recognized as an inference provider.
- Out-of-tree compute drivers via --compute-driver-socket flag.
- GPU count requests in CLI for sandbox creation.
- Environment variable passthrough with --env flag for sandbox create/exec.
- JSON-RPC and MCP L7 policy enforcement.
Improved
- Gateway now supports system registry and source indicators.
- High-availability deployments now use reconciler leases for multi-replica coordination.
- TLS certificates can be reloaded without restarting the server.
- Kubernetes driver now supports defaultruntimeclassname configuration.
- Profile-backed policy visibility added to providers.
- Provider profile updates now supported.
- CLI replaced sandbox create positional arguments with SandboxCreateConfig struct.
- Supervisor image configuration now honored in Docker driver.
Fixed
- Gateway now binds to 0.0.0.0 in rootless Podman mode on non-macOS systems.
- Config now rejects unknown fields in nested gateway configuration tables.
- Sandbox JWT in local environments no longer requires expiration.
- Exec relays no longer hang on idle connections.
- Forward proxy stale policy flakes in e2e testing.
- Linux glibc floor lowered to 2.28 to support RHEL/Rocky 8.
May 2026
16 releases: 0.0.37 → 0.0.52
May brought significant infrastructure and security improvements to OpenShell, including agent-driven policy management, enhanced authentication mechanisms, and better Kubernetes support. The month focused on hardening the gateway, sandbox isolation, and cross-platform compatibility.
- SSH handshake secret removed; use HTTPS/mTLS authentication instead
- Mise --no-prepare renamed to --no-deps
- VM driver now opt-in rather than default
Highlights
- Agent-driven policy management MVP launched with both server and agent-side implementations
- Removed SSH handshake secret in favor of separate HTTPS and mTLS authentication
- Added Prometheus metrics infrastructure for monitoring gRPC and HTTP requests
- Introduced support for Kubernetes nodeSelector, tolerations, and configurable workspace storage
- Prevented DNS-based data exfiltration and SSRF attacks in sandbox mechanistic mapper
New
- Prometheus metrics infrastructure and gRPC/HTTP request metrics
- Agent-driven policy management with MVP and agent-side implementations
- Local-domain service routing in gateway
- OIDC authentication support in TUI
- JSON and YAML output formats for sandbox and gateway list commands
- Kubernetes ImageVolumeSource support for supervisor sideload
- Device ID support for Docker and Podman GPU access
- Certificate generation command to replace init scripts
Improved
- Docker and Podman now use native Rust builds with split Dockerfiles
- Kubernetes gateway now includes e2e tests and gated CI workflow
- Custom CA support for OIDC issuer TLS verification in Helm
- Default workspace PVC storage size is now configurable in Kubernetes
- Local CLI rebuilds now faster
- Provider discovery now derives from profiles
- Sandbox download now supports cp-style operations with workspace-boundary checks
- Podman falls back to socket when Docker is unavailable
Fixed
- Removed DNS resolution from sandbox mechanistic mapper to prevent data exfiltration
- Fixed SQLite database file permissions restricted to 0o600
- Fixed OS trust store usage for TLS verification
- Prevented secret leakage in debug output with custom Debug derive
- Fixed SSRF block exemption for host gateway in rootless Podman
- Corrected /sandbox ownership when rootfs built by non-root host
April 2026
4 releases: 0.0.33 → 0.0.36
April brought significant security and operational improvements to OpenShell, with hardened sandbox enforcement, new compute driver support, and enhanced SSH connectivity. The month focused on reliability and policy management across sandbox operations.
Highlights
- Added standalone libkrun compute driver support for VM operations
- Implemented supervisor-initiated SSH connectivity over gRPC multiplexed relay
- Added incremental sandbox policy updates for more flexible configuration
- Hardened sandbox security with improved seccomp policies and process limits
- Added request-level logging and separate unauthenticated health endpoints
New
- Standalone libkrun compute driver for VM workloads
- Incremental sandbox policy updates capability
- Supervisor-initiated SSH connect and exec over gRPC-multiplexed relay
- Request-level logging via TraceLayer on server
- Health endpoints on separate unauthenticated port
- Configurable timeout for image transfer to gateway containerd
- Configurable disabling of health check listener
- Gateway-owned readiness and VM compute driver end-to-end testing
Improved
- Hardened seccomp policies for inference routing and process limits
- SSH session response field escaping and validation
- Sandbox policy retrieval now returns currently active runtime policy
- HTTP request-target canonicalization before L7 policy evaluation
- Kubernetes driver now uses dedicated client without read_timeout for watches
- Sandbox host alias resolution in SSRF checks
- Git clone operations now trust sandbox CA via GIT_SSL_CAINFO injection
- End-to-end testing expanded to run on external repository forks
Fixed
- Stripped " (deleted)" suffix from unlinked /proc/<pid>/exe paths
- Fixed flaky ARM64 procfs binary_path tests
- Applied supervisor seccomp prelude to sandbox
- Preserved explicit read-only baseline paths in sandbox configuration
- Fixed Kubernetes driver watch handling with proper timeout configuration
- Fixed health endpoint authentication requirements
Summaries are written automatically from the official release notes (full changelog ↗); check the original notes before relying on a detail. OpenShell: pricing, features and alternatives · All changelogs
