> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up on-premises integrations

> Create on-premises integrations in Cognite Data Fusion (CDF), install the extractor, and complete the connection.

Register an on-premises extractor as an **integration**, install it, and complete the **connection** to monitor **tasks**.

<Info>
  Integrations is in [public preview](/cdf/product_feature_status#public-preview) and may change. Creating an integration creates the integration resource only. It does **not** create an extraction pipeline. Do not use the Integrations path and the Extraction pipelines path for the same external ID at the same time.
</Info>

## Before you start

* Confirm you can open <span class="ui-element">Data fusion</span> > <span class="ui-element">Integrate</span> > <span class="ui-element">Integrations</span>. If not, contact [Cognite Support](/cdf/support/index) or your Cognite representative.
* Assign Integrations and destination [capabilities](/cdf/access/guides/capabilities#integrations) for the extractor.
* Review the setup guide for your source: [DB](/cdf/integration/guides/extraction/db/db_setup), [File](/cdf/integration/guides/extraction/file/file_setup), [SharePoint Online](/cdf/integration/guides/extraction/file/file_sharepoint_setup), or [OPC UA](/cdf/integration/guides/extraction/opc_ua/opc_ua_setup).

For on-premises integrations, assign `integrations:read`, `integrations:write`, `integrations:use`, `integrationconfigs:read`, and `integrationconfigs:write`. You do **not** need `extractionpipelines:*`, `extractionruns:*`, or `extractionconfigs:*` for this path.

## Create the integration

<Steps>
  <Step title="Open Integrations">
    Navigate to <span class="ui-element">Data fusion</span> > <span class="ui-element">Integrate</span> > <span class="ui-element">Integrations</span>.
  </Step>

  <Step title="Start setup">
    Select <span class="ui-element">Set up</span>. CDF opens <span class="ui-element">Extractors</span> so you can choose the extractor.
  </Step>

  <Step title="Choose and create">
    Select a supported on-premises extractor. For SharePoint Online, use the File extractor. Enter the name, external ID, and other required fields, then save.

    <Check>
      CDF creates the **integration** and shows download and connection instructions. You can also open <span class="ui-element">Extractors</span> under Integrate at any time.
    </Check>
  </Step>
</Steps>

## Complete the connection

Follow the on-page instructions. When the connection succeeds, the extractor has finished startup and check-in with CDF. **Tasks** appear only after that so you can monitor them.

<Steps>
  <Step title="Download and install the extractor">
    Download the package for your environment. Install the extractor on a host that can reach the source system and CDF.
  </Step>

  <Step title="Authenticate and start the extractor">
    Add CDF authentication to the local extractor configuration, then start the extractor so it can check in with CDF. Keep secrets out of shared samples.
  </Step>

  <Step title="Add remote configuration">
    Open the integration, select the <span class="ui-element">Configuration</span> tab, paste your local configuration file content, validate, and publish. Configuration is keyed by the integration external ID.

    <Tip>
      You can also download packages from <span class="ui-element">Data fusion</span> > <span class="ui-element">Integrate</span> > <span class="ui-element">Extractors</span>. See [About data extraction](/cdf/integration/concepts/extraction#download-installation-files).
    </Tip>
  </Step>

  <Step title="Confirm the connection">
    When the connection succeeds, open <span class="ui-element">Overview</span> tab and confirm that **tasks** are listed.
  </Step>
</Steps>

## Next steps

* Complete source-specific setup in the [DB](/cdf/integration/guides/extraction/db/db_setup), [File](/cdf/integration/guides/extraction/file/file_setup), or [OPC UA](/cdf/integration/guides/extraction/opc_ua/opc_ua_setup) guide.
* [Monitor integrations](/cdf/integration/guides/interfaces/monitor_unified_integrations).
* To keep using Extraction pipelines, see [Set up extraction pipelines](/cdf/integration/guides/interfaces/add_integrations).