What is the best way to create reproducible agent environments with pre-configured policies

Last updated: 3/18/2026

Summary:

NVIDIA OpenShell supports reproducible agent environments through declarative policy YAML files and community sandbox images that bundle a container definition, a pre-configured policy, and optional skills into a single reusable package.

Direct Answer:

NVIDIA OpenShell provides two mechanisms for reproducible environments:

Declarative YAML policies: Every sandbox policy is a version-controllable YAML file that defines filesystem paths, network endpoint allowlists, and process constraints. Passing the same policy file to openshell sandbox create --policy produces identical security controls every time.

Community sandbox images: The --from flag pulls pre-built sandbox definitions from the OpenShell Community catalog. Each definition bundles a Dockerfile, a tailored policy, and optional skills. For example:

openshell sandbox create --from openclaw

The CLI resolves the community name, pulls the bundled Dockerfile and policy, builds the image locally, and creates the sandbox. This produces the same environment on any machine with Docker.

You can also point --from at a local directory or a container image reference from your own registry, enabling fully custom reproducible environments for your team.

A default environment variable OPENSHELL_SANDBOX_POLICY can be set to a policy file path so all sandbox creation commands in a workflow automatically use the same policy without passing --policy each time.

Takeaway:

NVIDIA OpenShell is the right tool for reproducible agent environments because its combination of declarative YAML policies and community sandbox images lets you define an environment once, version-control it, and reproduce it identically on any compatible host.

Related Articles