Creating a Qlik Sense Client-Managed connection

Last updated: 2026-11-03

This page explains how to create a source connection to a Qlik Sense Client-Managed environment using the Qlik Analytics Migration Tool. This connection enables migration of content from a self-hosted Qlik Sense environment into Qlik Cloud.

Two methods are available:

• Method 1 — Use an existing virtual proxy already configured with JWT authentication.
• Method 2 — Use the Qlik Analytics Migration Tool to automatically create a new virtual proxy.

After a connection is created, it shows the Qlik Sense product version and release label of the server. The version is shown in the same form as in the Qlik Management Console (QMC), for example 14.254.1.1 (November 2025 Patch 3).

Method 1: Use an existing virtual proxy

This method is applicable when a JWT-enabled virtual proxy is already configured in the Qlik Sense Client-Managed environment.

Steps

Do the following:

1. Navigate to the Connections tab and select Qlik Sense Client-Managed.
2. Click Create New.
3. In the Connection Setup tab, provide the following:
   • Connection Name — A reference name for identifying the connection.
   • Qlik Sense Virtual Proxy URL — The full URL to the configured virtual proxy (for example, https://qliksense.domain.com/proxy-name).
   • API Key / JWT — The JWT associated with the configured virtual proxy. This value will be masked when entered.
4. Click Test Connection to validate the configuration.
   • A success notification confirms the connection is valid.
   • If the test fails, verify the URL and token. The error message may provide additional details.
5. Click Create Connection.
6. A confirmation message will indicate successful creation, and the connection will appear in the list.

Method 2: Create a virtual proxy using the tool

This method allows the Qlik Analytics Migration Tool to create a new virtual proxy and associated JWT, without requiring one to exist beforehand.

Steps

Do the following:

1. Navigate to the Connections tab and select Qlik Sense Client-Managed.
2. Click Create New.
3. On the Virtual Proxy Setup – Guide tab, review the instructions (optional).
4. Switch to the Virtual Proxy Setup tab.
5. In the Qlik Server URL field, enter the login URL of the Qlik Sense Client-Managed environment.
6. Click Login to Qlik. A new tab will open prompting for authentication.
7. After logging in, open Developer Tools (F12 or fn + F12) in the web browser.
8. Go to the Application tab, then:
   1. Expand the Cookies section.
   2. Select the Qlik Sense domain.
   3. Copy the Cookie Name. In the Qlik Analytics Migration Tool, paste it into the Qlik Session Cookie (Cookie Name) field.
   4. Copy the Cookie Value. In the Qlik Analytics Migration Tool, paste it into the Qlik Session Cookie (Cookie Value) field.
9. Click Retrieve users and proxies from Qlik.
   • This fetches all RootAdmin users and available proxies.
   • If the call fails, verify the cookie fields and re-authenticate if needed.
10. In the Select Service User dropdown, select a RootAdmin user to associate with the virtual proxy. Make sure to pick a user that already has or can be assigned a Professional license.
11. In the Select Proxy Service dropdown, select the proxy service (typically Central).
12. Optionally, set a Virtual Proxy Name (no spaces allowed).
13. Click Create Virtual Proxy.

• Before the virtual proxy is created, the Qlik Analytics Migration Tool checks that the node serving the address that you typed is the node that the virtual proxy will be linked to. If the nodes do not match, you must acknowledge the mismatch before the virtual proxy is created.
• The check cannot see across network address translation (NAT). If the address is public and the node is private, the result is shown as unknown rather than as a mismatch.
• A success notification confirms the proxy was created.
• If unsuccessful, verify all input fields and review any error messages.

14. After proxy creation, a JWT token will be displayed (optional to save). The token of a virtual proxy cannot be reissued. If the token is lost, create a new virtual proxy.
15. Click Go to Connection Setup.

• All connection fields will be auto-filled using the proxy information.

16. Click Test Connection to validate the setup.
17. Click Create Connection.
18. A confirmation message will appear and the connection will be added to the list.

Deleting the connection

When you delete a Qlik Sense Client-Managed connection that created a virtual proxy, you are offered the option to delete the virtual proxy that the Qlik Analytics Migration Tool created for it. For details, see Deleting connections.

Related topics

• Managing connections
• Creating a Qlik Sense Client-Managed connection
• Creating a migration plan