# Installing the Qlik Analytics Migration Tool

The Qlik Analytics Migration Tool includes a guided installer that streamlines deployment while supporting advanced configurations for enterprise environments. This installation guide outlines each step, including certificate setup, port validation, service account configuration, and final verification.

## Prerequisites

Confirm that all [System requirements](https://help.qlik.com/en-US/migration/Content/AnalyticsMigrationTool/Installation/System-Requirements.htm) are met, including supported operating systems, disk space, memory, permissions, and network access.

Information note

If you are working with Qlik Cloud Government or Qlik Cloud Government - DoD, ensure you have activated FIPS encryption before installing.

## Installation steps

### 1. Download the installer

Download the Qlik Analytics Migration Tool installer from the [Qlik Community](https://community.qlik.com/t5/Download-Qlik-Products/tkb-p/Downloads).

### 2. Run the installer as administrator

Right-click the downloaded `.exe` file and select Run as administrator to launch the guided setup.

### 3. Accept the license agreement

Do the following:

1. Review the End User License Agreement.
2. Select Accept to proceed.

### 4. Install required runtime

If prompted, install the required .NET packages.

### 5. Enter company name

Provide a company name to be used as a display label within the Qlik Analytics Migration Tool.

Information note

This does not need to reflect a legal entity.

### 6. Configure certificate and domain

#### Dedicated server

* Certificate: Select a valid third-party SSL/TLS certificate from the LocalMachine certificate store.
* Domain: Enter the fully qualified domain name (FQDN) that matches the certificate (for example, `migrationtool.company.com`).

Ensure the certificate presented in the browser after installation matches the configured domain. A browser warning typically indicates a mismatch.

#### Non-dedicated server (evaluation)

* Certificate: Use a self-signed certificate.

### 7. Configure ports

* Default Ports:
  * HTTP: 9037
  * HTTPS: 9038
* Dedicated Server Option:
  * HTTP: 80
  * HTTPS: 443

To validate port availability:

* `netstat -ano | findstr :80`
* `netstat -ano | findstr :443`
* `netstat -ano | findstr :9037`
* `netstat -ano | findstr :9038`

To identify which process is using a port:

* `tasklist /FI "PID eq <PID>"`

### 8. Configure optional email notifications

Enter SMTP server details to enable user invitation notifications via email.

This step is optional.

### 9. Select authentication type

Choose Windows Authentication (default and recommended).

Azure Entra ID is also supported, currently in preview and not fully documented.

### 10. Set administrator and service account

#### Admin user

Enter a Windows account to serve as the initial administrator.

This account will be used to access the web interface after installation.

#### Service account

Select the Windows service account type:

* `Windows User`: Specify a domain account manually.
* `Local System`: Use the built-in system context.

Information note

**Important:**

If migrating file-based data (for example, QVDs, CSVs, TXT), select a domain account with appropriate access to the necessary file shares.

If file migration is not required, `Local System` may be used.

If you are using direct file paths to non-network drives (example: the data connection is an absolute path to the C or D drives), then either the Qlik Analytics Migration Tool must be installed on same server as Qlik Sense or those data connections must be changed to reference network share folder paths.

##### Updating the service account After installation

Do the following:

1. Open services.msc.
2. Locate Qlik Analytics Migration Tool.
3. Right-click → Properties → Log On tab.
4. Select This account and provide domain credentials.
5. Click Apply, then restart the service.

### 11. Configure proxy (optional)

If a proxy is required for outbound internet access:

* Check the Enable Proxy box.
* Enter the proxy address and port.
* Check the Use default Windows credentials box, or enter authentication credentials if applicable.

### 12. Select installation directory

Choose a destination folder with sufficient free space to support:

* Exported or imported Qlik apps
* Migrated data files (QVDs, CSVs, and so on)
* Log files and backups

Qlik apps are exported without data by default. When exporting with data or migrating large datasets, ensure sufficient disk capacity.

### 13. Final setup options

* Create Desktop Shortcut: Add a shortcut to the desktop.
* Launch Application After Install: Automatically open the tool in the browser upon completion.

Select Install to begin the installation process.

## Completion

After installation:

If Launch Application After Install was enabled, the Qlik Analytics Migration Tool will open automatically.

Otherwise, access the tool using a supported browser:

* If a self-signed certificate was used on a non-dedicated machine:  
  `https://<machine-name>:<HTTPS port>`

* If a third-party certificate was used:  
  `https://<FQDN>` (using port 443, else include selected HTTPS port)

Log in using the configured admin account and verify that:

* The web interface is accessible.
* All services are operational.

## Related pages

* [System requirements](https://help.qlik.com/en-US/migration/Content/AnalyticsMigrationTool/Installation/Installing-the-Qlik-Analytics-Migration-Tool.htm#system-requirements)
* [Planning Your migration](https://help.qlik.com/en-US/migration/Content/AnalyticsMigrationTool/Installation/Installing-the-Qlik-Analytics-Migration-Tool.htm#planning-your-migration)
* [Managing users](https://help.qlik.com/en-US/migration/Content/AnalyticsMigrationTool/Installation/Installing-the-Qlik-Analytics-Migration-Tool.htm#managing-users)
* [Creating plans](https://help.qlik.com/en-US/migration/Content/AnalyticsMigrationTool/Installation/Installing-the-Qlik-Analytics-Migration-Tool.htm#creating-plans)
* [Running jobs](https://help.qlik.com/en-US/migration/Content/AnalyticsMigrationTool/Installation/Installing-the-Qlik-Analytics-Migration-Tool.htm#managing-jobs)