Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 10 additions & 1 deletion docs/src/01-install/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,10 +81,19 @@ The development of IoT drivers on Critical Manufacturing MES has a dependency fo

## 2. Install CLI

!!! warning "NPM `allow-scripts` requirement"

Recent NPM versions may block install-time scripts by default as a
security measure. Since `@criticalmanufacturing/cli` relies on install
scripts, the installation can fail or complete incompletely unless the
package is explicitly allowed to run them. The first command below
allows the package's install scripts before installing.

1. Open a command line with administration privileges.
2. Execute the command:
2. Execute the commands:

```PowerShell
npm config set allow-scripts=@criticalmanufacturing/cli --location=user
npm install -g @criticalmanufacturing/cli
```

Expand Down
11 changes: 11 additions & 0 deletions docs/src/03-explore/plugins/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,3 +5,14 @@ The Critical Manufacturing cli is designed with a plugin system for extensibilit
In the meanwhile, some plugins are already in development. Here follows a non-exhaustive plugin list:

- [Portal SDK](https://www.npmjs.com/package/@criticalmanufacturing/portal) - command line tools to interact with the Critical Manufacturing Customer Portal.

!!! warning "NPM `allow-scripts` requirement"

Plugins are distributed as NPM packages, so the same
[`allow-scripts` requirement](../../01-install/index.md#2-install-cli)
that applies to installing the CLI also applies to them. Before
installing a plugin, add it to the `allow-scripts` allowlist, e.g.:

```PowerShell
npm config set allow-scripts=@criticalmanufacturing/portal --location=user
```
Loading