> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/adapters/troubleshooting/installation-location/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Installation location

> How adapter namespaces determine where an adapter must be installed within theItential Platform node_modules directory.

Adapters are scoped to a namespace, and the adapter must be installed in the directory that matches that namespace within theItential Platform `node_modules` directory. If the installed path does not match the namespace defined in the adapter files (such as `package.json` and `pronghorn.json`), the adapter will not load.

NewerItential Platform releases align namespace rules with npm conventions — uppercase letters are no longer valid in namespaces. An adapter with an uppercase namespace will still load, but you will not be able to set service instance configuration values inItential Platform Admin Essentials without first updating the namespace.

## Common namespaces

**`@itentialopensource`** — most open-source Itential adapters. Install to:
`<IAP-Home>/node_modules/@itentialopensource/<adapter-name>`

Example: `/opt/itential/current/node_modules/@itentialopensource/adapter-aws_ec2`

**`@itential`** — adapters bundled withItential Platform by default, including severalItential Platform authentication adapters (such as `adapter-ldap`) and specialized orchestration adapters (such as `adapter-nso`). Install to:
`<IAP-Home>/node_modules/@itential/<adapter-name>`

Example: `/opt/itential/current/node_modules/@itential/adapter-nso`

**Custom namespaces** — adapters built by Itential Professional Services or by customers may use their own namespace. Install to:
`<IAP-Home>/node_modules/@<namespace>/<adapter-name>`

Example: `/opt/itential/current/node_modules/@mycompany/adapter-mycustomadapter`

If the adapter is not installed in the correct directory, it will fail to load whenItential Platform is restarted.

> How adapter namespaces determine where an adapter must be installed within theItential Platform node_modules directory.