Skip to content

feat(install): support portable air-gapped production deployment bundles #4872

Description

@wscurran

Summary

Define and support an official NemoClaw production deployment workflow for restricted or fully air-gapped environments, including a portable install-bundle path where an operator can prepare a NemoClaw install on a connected machine, copy the required artifacts to removable media such as a USB drive, and install/run NemoClaw on an isolated target machine.

Parent: #2218

Problem

Today operators who need to deploy NemoClaw in restricted production environments must build custom wrappers around install, image pull, dependency staging, credentials, registry access, and policy setup. This is risky and hard to support.

A concrete desired workflow is:

  1. Prepare or download the required NemoClaw artifacts on a connected machine.
  2. Copy the install bundle to a USB drive or similar removable media.
  3. Move the bundle to an isolated target machine.
  4. Install and run NemoClaw without requiring direct internet access.

Proposed Scope

  • Document the minimum production deployment prerequisites.
  • Define the required offline artifacts: container images, npm/package dependencies, OpenShell/OpenClaw assets, model/provider prerequisites, and policy presets.
  • Provide a supported workflow for staging those artifacts into an internal registry, local cache, or portable offline bundle.
  • Make install/onboard failures in restricted networks actionable.
  • Document how secrets and credentials should be handled in production without baking them into images.

Non-goals

  • Do not promise that every provider/model works offline.
  • Do not replace site-specific DevOps automation.
  • Do not weaken sandbox/network policy for convenience.

Acceptance Criteria

  • Docs describe a supported restricted-network deployment workflow.
  • Docs describe a portable USB/offline-bundle install path.
  • Required images/packages/artifacts are listed explicitly.
  • Operators can pre-stage artifacts in an internal registry/cache or removable-media bundle.
  • Install/onboard docs explain how to configure proxy, registry, and certificate requirements.
  • Secrets are not embedded in images or offline bundles.
  • Known unsupported offline/provider combinations are documented.

Activity

  1. added
    enhancementNew capability or improvement request
    area: docsDocumentation, examples, guides, or docs build
    area: installInstall, setup, prerequisites, or uninstall flow
    area: networkingDNS, proxy, TLS, ports, host aliases, or connectivity
    area: packagingPackages, images, registries, installers, or distribution
    area: securitySecurity controls, permissions, secrets, or hardening
    needs: designRequires product or architecture direction
    on Jun 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area: docsDocumentation, examples, guides, or docs buildarea: installInstall, setup, prerequisites, or uninstall flowarea: networkingDNS, proxy, TLS, ports, host aliases, or connectivityarea: packagingPackages, images, registries, installers, or distributionarea: securitySecurity controls, permissions, secrets, or hardeningneeds: designRequires product or architecture direction

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions