Install npm libraries in an air-gapped environment
To enable UI development and bundling in a secure or disconnected environment, you must install required npm libraries into a private registry and configure the platform to use it. This step is especially important in air-gapped environments, where all dependencies must be preloaded and resolved from a single internal source.
To learn how to configure your private npm registry and set up the development environment for air-gapped use, see Set up Application Development in an Air-Gapped Environment
Before you begin
Before you attempt to use an npm library in your air-gapped environment:
- Check if the library exists in your private registry.
- Check that your registry includes the specific version you need.
These steps help prevent common errors where the bundler fails due to a missing or incorrect dependency. Also make sure your npm client authenticates correctly with your internal registry.
If you’re not sure how to verify authentication or troubleshoot access errors, see Set up Application Development in an Air-Gapped Environment
Validate access with npm install
The fastest way to confirm that your environment works and the registry contains the library is to install it locally:
npm init -y # Create a temporary test project
npm install --save <package> # Try to install the desired libraryIf the installation succeeds, that means:
- Your internal registry contains the package.
- The specific version you need is present.
- Your local machine successfully authenticated.
If the installation fails, don’t update your C3 package yet. Instead, troubleshoot the issue using the air-gapped setup guide.
Add the library to your C3 package
Once you’ve successfully installed the library, update your application’s runtime configuration to include it. For instructions, see Use npm libraries in your C3 UI application