You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit bc14018
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: .agents/skills/debug-openshell-cluster/SKILL.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -148,6 +148,7 @@ Common findings:
148
148
- Docker daemon unavailable: start Docker Desktop or Docker Engine.
149
149
- Gateway process stopped: inspect exit status and logs.
150
150
- Sandbox image missing or pull denied: verify image reference and registry credentials.
151
+
- Sandbox fails before readiness with an identity-resolution error: inspect the image's OCI `USER` and matching `/etc/passwd` and `/etc/group` entries, or explicitly set both process identity fields in policy. Root and missing identities are rejected.
151
152
- Docker driver cannot initialize because it cannot find `openshell-sandbox`: verify `OPENSHELL_DOCKER_SUPERVISOR_BIN`, the sibling binary next to `openshell-gateway`, or the configured supervisor image contains `/openshell-sandbox`.
152
153
- Sandbox never registers: check gateway logs and supervisor callback endpoint.
153
154
- Supervisor image exits before printing `openshell-sandbox --version`: the image should be the scratch supervisor image from `deploy/docker/Dockerfile.supervisor` and must contain a static executable at `/openshell-sandbox`.
@@ -173,6 +174,7 @@ Common findings:
173
174
- Podman socket unavailable: start or expose the user socket.
- Sandbox image missing or pull denied: verify image reference and registry credentials.
177
+
- Sandbox fails before readiness with an identity-resolution error: inspect the image's OCI `USER` and matching `/etc/passwd` and `/etc/group` entries, or explicitly set both process identity fields in policy. Root and missing identities are rejected.
Copy file name to clipboardExpand all lines: .agents/skills/generate-sandbox-policy/SKILL.md
+7-5Lines changed: 7 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -473,15 +473,17 @@ filesystem_policy:
473
473
landlock:
474
474
compatibility: best_effort
475
475
476
-
process:
477
-
run_as_user: sandbox
478
-
run_as_group: sandbox
479
-
480
476
network_policies:
481
477
# <generated policies go here>
482
478
```
483
479
484
-
The `filesystem_policy`, `landlock`, and `process` sections above are sensible defaults. Tell the user these are defaults and may need adjustment for their environment. Gateway inference is configured separately through `openshell inference set/get`. The generated `network_policies` block is the primary output.
480
+
The `filesystem_policy` and `landlock` sections above are sensible defaults.
481
+
Process identity is omitted so the selected compute driver can choose it. For
482
+
Docker and Podman, each omitted identity field falls back to the image's OCI
483
+
`USER`. Tell the user these are defaults and may need adjustment for their
484
+
environment. Gateway inference is configured separately through `openshell
485
+
inference set/get`. The generated `network_policies` block is the primary
486
+
output.
485
487
486
488
If the user provides a file path, write to it. Otherwise, ask where to place it. A common convention is a project-local policy file (e.g., `sandbox-policy.yaml`) passed to `openshell sandbox create --policy <path>` or set via the `OPENSHELL_SANDBOX_POLICY` env var.
Copy file name to clipboardExpand all lines: .agents/skills/generate-sandbox-policy/examples.md
+4-5Lines changed: 4 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -830,10 +830,6 @@ filesystem_policy:
830
830
landlock:
831
831
compatibility: best_effort
832
832
833
-
process:
834
-
run_as_user: sandbox
835
-
run_as_group: sandbox
836
-
837
833
network_policies:
838
834
github_readonly:
839
835
name: github_readonly
@@ -858,7 +854,10 @@ network_policies:
858
854
- { path: /usr/local/bin/claude }
859
855
```
860
856
861
-
The agent notes that `filesystem_policy`, `landlock`, and `process` are sensible defaults that may need adjustment, and that gateway inference is configured separately via `openshell inference set/get` rather than an `inference` policy block.
857
+
The agent notes that `filesystem_policy` and `landlock` are sensible defaults
858
+
that may need adjustment. Process identity is omitted so the compute driver can
859
+
select it. Gateway inference is configured separately via `openshell inference
Copy file name to clipboardExpand all lines: .agents/skills/openshell-cli/SKILL.md
+6Lines changed: 6 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -422,6 +422,12 @@ The `--from` flag accepts a Dockerfile path, a directory containing a Dockerfile
422
422
423
423
Local Dockerfile and directory builds require a local gateway because the CLI builds through the local Docker daemon. Use a registry image reference for remote gateways. Bare community names resolve under `ghcr.io/nvidia/openshell-community/sandboxes` unless `OPENSHELL_COMMUNITY_REGISTRY` overrides the prefix.
424
424
425
+
For Docker and Podman gateways, custom images should declare a non-root OCI
426
+
`USER`. Each explicit `process.run_as_user` or `process.run_as_group` policy
427
+
field wins independently; omitted fields fall back to the image declaration.
428
+
An image with no `USER` fails before readiness unless policy supplies both
0 commit comments