> For the complete documentation index, see [llms.txt](https://docs.inogic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.inogic.com/attach2dynamics/setup-wizard.md).

# Setup Wizard

### Introduction

Attach2Dynamics helps organizations move attachments, notes, and emails from Dynamics 365 / Dataverse to external storage platforms such as **SharePoint, Azure Blob Storage, and Dropbox**. By moving files to external storage, organizations can reduce Dataverse storage consumption while keeping documents accessible from within Dynamics 365.

Attach2Dynamics provides individual configuration pages for managing Connectors and Entity Configurations. However, completing the initial configuration through these pages requires administrators to navigate between different sections and configure each component separately.

The **Attach2Dynamics Setup Wizard** simplifies this process by bringing the essential configuration tasks together in a guided, step-by-step experience. It helps administrators verify the required prerequisites, configure a storage Connector, and create Entity Configurations in a logical sequence.

#### When to Use the Setup Wizard

Use the **Setup Wizard** when configuring Attach2Dynamics for the first time in your Dynamics 365 / Dataverse environment. It guides administrators through the initial setup requirements and helps configure the necessary Connectors and Entity Configurations in the correct sequence.

After completing the initial setup, if you need to make changes to existing configurations, such as updating Connector settings or modifying Entity Configurations, you can make those changes directly from their respective configuration pages without running through the Setup Wizard again.

#### Supported Storage Connectors

Attach2Dynamics supports the following three types of storage Connectors:

* **SharePoint:** Move and store Dynamics 365 / Dataverse attachments, notes, and emails in SharePoint.
* **Azure Blob Storage:** Move and store supported files in Azure Blob Storage.
* **Dropbox:** Move and store supported files in Dropbox.

You can configure multiple Connectors based on your organization's storage requirements and associate the appropriate Connector with each Entity Configuration.

This document provides step-by-step instructions for completing the initial Attach2Dynamics configuration using the Setup Wizard. The initial setup typically takes approximately **10–15 minutes**.

### Before you begin — Prerequisites

#### Set up Attach2Dynamics

The **Set up Attach2Dynamics** screen is the starting point of the Setup Wizard. Before configuring a storage Connector, select your preferred storage platform and verify that your Dynamics 365 / Dataverse environment meets the required prerequisites.

#### Select the Connector Type

Under **Where will your files be stored?**, select the storage platform where you want Attach2Dynamics to store your attachments, notes, and emails.

The available Connector Types are:

* SharePoint
* Azure Blob Storage
* Dropbox

For example, select **SharePoint** if you want to store your files in SharePoint.

The selected Connector Type determines which prerequisites are checked and which storage Connector is configured in the subsequent steps.

#### Verify the Prerequisites

The **Before you begin — Prerequisites** section displays the requirements that must be satisfied before proceeding with the setup.

Click **Re-run check** to verify the prerequisites for your selected storage platform. Each requirement is marked as verified only after the corresponding check is successful.

For the SharePoint Connector, the wizard checks the following requirements:

1. **Attach2Dynamics License Activated**

Confirms that the Attach2Dynamics license is activated for your current Dataverse environment. The license validity date is also displayed.

If your license requires activation or renewal, click **Re-Activate**.

For more information, refer to the [License Activation documentation](https://docs.inogic.com/attach2dynamics/getting-started/license-activation).

2. **Attach2Dynamics Solution Imported**

Confirms that the Attach2Dynamics solution is imported into your Dynamics 365 environment. The installed solution version is displayed.

3. **System Administrator Role Assigned**

Confirms that you are signed in with the System Administrator security role, which is required to complete the initial setup.

For more information, refer to the [Attach2Dynamics documentation](https://docs.inogic.com/attach2dynamics).

4. **Server-Based SharePoint Integration Configured**

Verifies that server-based SharePoint integration is configured for your organization. The wizard displays the SharePoint site against which the integration was validated.

For more information, refer to the [CRM–SharePoint Integration documentation](https://docs.inogic.com/attach2dynamics/prerequisites/connector-settings/crm-sharepoint-integration).

5. **Default Document Management Settings Configured**

Confirms that the default document management settings are selected for your organization. The configured document location and SharePoint site are displayed.

For more information, refer to the [CRM–SharePoint Integration documentation](https://docs.inogic.com/attach2dynamics/prerequisites/connector-settings/crm-sharepoint-integration).

#### Proceed with Setup

Once all applicable prerequisites are verified, review their status and click **Get Started** to proceed to the next configuration step.

If any prerequisite is not verified, complete the required configuration and click **Re-run check** to verify it again.

<figure><img src="https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FdGG5Jvry3mCanW0oMDIw%2Fimage.png?alt=media&amp;token=2d9dc472-5479-4301-a3da-7fa27b50cda9" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** The prerequisites displayed depend on the selected Connector Type. Make sure all applicable prerequisites are verified before proceeding.
{% endhint %}

&#x20;
