For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Open sourceSupportFAQsDocs Home
  • Introduction
    • Overview
    • Retired adapters
      • Overview
      • Result codes
      • Connectivity
      • Authentication
      • Connectivity
      • Dependencies
      • Installation location
      • URL paths
        • Adapter not in Itential Platform
        • Adapter status is red
        • No calls working
        • DEPTH_ZERO_SELF_SIGNED_CERT
        • Wrong response data
        • Wrong request data
        • One or more calls failing
        • Tasks not in Platform
        • Troubleshoot linting and testing
LogoLogo
Open sourceSupportFAQsDocs Home
On this page
  • Issue
  • What to check
TroubleshootSpecific scenarios

Adapter not in Itential Platform

Was this page helpful?
Previous

Adapter status is red

Next
Built with

Issue

The adapter is installed andItential Platform has been restarted, but the adapter is not available inItential Platform.

What to check

Verify the installation directory. The adapter must be installed in the directory that matches its namespace. See Installation location.

Verify dependencies are installed in the adapter directory. Run npm install from inside the adapter directory, not from theItential Platform home directory. See Dependencies.

Verify the adapter lints clean. Syntax errors in particular can preventItential Platform from loading the adapter. Run npm run lint:errors from the adapter directory. See Linting.

Check theItential Platform logs. WhenItential Platform fails to load an adapter, it writes an error to the log. The log entry typically identifies the cause.

Check for namespace and pronghorn.json compatibility issues. Newer versions ofItential Platform have stricter requirements for pronghorn.json and enforce npm-compatible namespace rules (no uppercase letters). These requirements can prevent the adapter from loading and may also prevent the service instance configuration from being editable inItential Platform Admin Essentials.

Adapters built before November 2019 that have not been migrated to a newer version may fail to load on currentItential Platform releases.

If the logs do not identify the cause, contact the Itential Adapters Team with the log output.