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

# Install adapters

> Deploy adapters to Itential Platform through Admin Essentials or command line.

Follow these best practices when installing or building an adapter. For Itential Platform adapter installation and migration, see [Install and migrate adapters and custom applications](/itential-platform/install/apps-adapters).

## Best practices for a new adapter installation

Follow these steps whenever you install or build a new adapter:

#### Install the adapter in the correct directory

Install to `<IAP-Home>/node_modules/@<namespace>/adapter-<name>`.

Example: `/opt/pronghorn/current/node_modules/@itentialopensource/adapter-sevone`

For Platform 6, install to `/opt/itential/platform/services/adapter-name` instead. See [Install and migrate adapters and custom applications](/itential-platform/install/apps-adapters).

#### Install adapter dependencies

Run `npm install` from inside the adapter directory — not from the Itential Platform home directory.

#### Lint the adapter

```bash
npm run lint
```

#### Run unit tests

```bash
npm run test:unit
```

#### Run standalone integration tests

```bash
npm run test:integration
```

#### Run true integration tests (if an instance is available)

Update the connection properties in the integration test file, then run:

```bash
npm run test:integration
```

If any tests fail, enable debug logging and review the `OPTIONS`, `REQUEST`, `CALL RETURN`, and `RESPONSE` log entries to identify the issue.

## What's next

#### [Configure adapter](/adapters/configure/service-instance-configuration/properties/overview)

Set connection and auth

#### [Test adapter](/adapters/test/test-and-lint-adapters)

Verify functionality

#### [Customize code](/adapters/customize/examples)

Add custom logic

#### [Troubleshoot](../troubleshooting/overview)

Fix issues

## Related reading

* [Install and migrate adapters](/itential-platform/install/apps-adapters)
* [High Availability setup](/itential-platform/install/apps-adapters#high-availability-setup)
* [Adapters in Admin Essentials](/itential-platform/admin-essentials/adapters)