Skip to main content Skip to complementary content

Installing Qlik Sense on a single node

A basic installation of Qlik Sense can be done by installing all of the Qlik Sense services on a single node. This kind of deployment works best in a single time zone, where reloads of data can be done during the night. To determine if a single-node installation is the right choice for you, see Planning your deployment.

For information about multi-node deployments of Qlik Sense, see Installing Qlik Sense in a multi-node site.

Before you install:

  • Check that your environment meets the system requirements.

    See: System requirements for Qlik Sense

  • Check that the required ports are available.

    See: Ports

  • Check that your browser is supported.

    See: Supported browsers

  • Prepare the user accounts required to run the Qlik Sense services.

    See:User accounts

  • Understand how Qlik Sense uses LEF for site licensing and user access allocation, and have your license key available.

    See:Licensing

Do the following:

  1. Log in to the computer where you plan to install Qlik Sense as a local Windows administrator.

    See: User accounts.

  2. Create a file share before you run the Qlik Sense setup. The file share is a shared folder that stores all the Qlik Sense application data.
    1. Create a new folder.
    2. Right click on the folder, and click Properties.
    3. On the Sharing tab, and click Share.
    4. Enter the names of Windows users that you want to share the folder with, and click Add.

      Share this folder with your WindowsQlik Sense administrator and your WindowsQlik Sense services user. For more information, see User accounts.

    5. In the Permission level column, select Read/Write, and click Share.
      Information noteMake note of the network path displayed on the confirmation screen. You will enter this information during the Qlik Sense setup. The network path will be in the following format: \\server-name\QlikShare
  3. Download the Qlik_Sense_setup.exe file from www.qlik.com, and launch the setup.
  4. Do the following:

    1. Accept the license agreement, and click Next.
    2. On the Create or join a cluster screen, click Create cluster.
    3. On the Host Name screen, enter the name of the computer that you are installing Qlik Sense on and click Next.
    4. On the Shared persistence database connections settings screen, select the Install local database check box if you want to install a local repository database, or leave the check box unchecked if you want to connect to an existing repository database.
    5. See: Installing and configuring PostgreSQL

      If you want to connect to an existing repository database, then enter the following values:

      Field nameValue
      Database host nameEnter the full URL to your repository database.
      Database port 4432
      Database user

      Enter the username that will be used to access the database.

      Warning noteDo not enter the username postgres.
      Database user passwordCreate your own database user password to access your repository database in the PostgreSQL database.

    6. On the Database configuration screen, click Next.

      There is no need to configure the database service to allow connections from other nodes in a single-node installation.

    7. On the Shared persistence storage screen, enter the path or URL to your file share, for example \\<domain>\QlikShare, and click Next. Your file share can either be a local folder or a remote folder.
    8. On the Centralized Logging screen, leave the Configure centralized logging check box selected if you want to set up centralized logging, or clear the check box if you want logs to be written to files. If you decide not to set up centralized logging at this time, you can set it up later by using the logging service utility; see Qlik Logging Service.

    9. If you want to write logs to a new database that is installed with Qlik Sense, click New logging database. Enter the following values and click Next.

      Field name Value
      Log writer password Create a password for the qlogs_writer user to access the centralized PostgreSQL database.
      Log reader password

      Create a password for the qlogs_reader user to access the centralized PostgreSQL database.

      If you want to write logs to an existing database on the same node that you are installing Qlik Sense on or on another node, click Standalone logging database. Enter the following values and click Next.

      Field name Value
      Hostname Enter the host name or IP of the centralized PostgreSQL database.
      Port

      4432

      Log writer password

      Enter the password for the qlogs_writer user to access the centralized PostgreSQL database.

      Log reader password Enter the password for the qlogs_reader user to access the centralized PostgreSQL database.

      If you use a logging database on another node, ensure that this is a new and empty logging database before proceeding with the installation. If a QLogs db is already present on the remote database the schemas may be incompatible.
      See: Installing and configuring PostgreSQL

    10. On the Installation location screen, choose your own installation location or install Qlik Sense to the default location on the C:\ drive, and click Next.
    11. On the Repository Database Superuser Password screen, enter a password for the PostgreSQL repository database superuser. Confirm the password and click Next.

      See, User accounts.

    12. On the Service Credentials screen, enter the domain, user name and password for the account that you want use to run the Qlik Sense services, and click Next.

      Information noteIf you enter a username that is more than 20 characters long, it must be in UPN format, and must include the full domain name. For example, longusername@full.domain.name.
  5. On the Ready to install screen, select the appropriate check boxes if you want the setup to create desktop shortcuts and automatically start the Qlik Sense services when the setup is complete.
    Information noteIf you selected local system as the user account type in the Service Credentials screen, but wish to use a dedicated service account to run the Qlik Sense services, clear the Start the Qlik Sense services when the setup is complete checkbox.
  6. Click Install.

    You will see a message indicating that Qlik Sense has been installed successfully.

  7. Click Finish.
  8. If you selected local system as the user account type in the Service Credentials screen, but wish to use a dedicated service account to run the Qlik Sense services change the user account type and manually start the Qlik Sense services now. See Changing the user account to run Qlik Sense services

You are ready to license your Qlik Sense installation.

Licensing Qlik Sense

Before you can start using Qlik Sense you must activate your site license.

Do the following:

  1. Open the QMC.

    When you open the QMC for the first time the Site license properties screen is displayed.

  2. Enter the license information from the License Enabling File (LEF).

    The property group Site license contains properties related to the license for the Qlik Sense system. All fields are mandatory and must not be empty.

    Property nameDescription
    Owner nameThe user name of the Qlik Sense product owner.
    Owner organizationThe name of the organization that the Qlik Sense product owner is a member of.
    Serial numberThe serial number assigned to the Qlik Sense software.
    Control numberThe control number assigned to the Qlik Sense software.
  3. Expand LEF access and click Get LEF and preview the license. If you received your LEF via email, you can copy and paste the information into the text field.
  4. Information noteFailed to get LEF from server is displayed if the serial number or control number is incorrect.
  5. Click Apply.

    Successfully licensed is displayed.

  6. Click Close.

You have activated your Qlik Sense site license.

You are ready to connect to a user directory (optional), allocate user access or professional access, and set up permissions.

Allocating user access or professional access

Your license is either user-based, with professional access allocation as an option, or token-based, with user access allocation as an option.

User-based license

Your Qlik Sense license includes a number of professional access allocations that are used to grant users in your organization access to Qlik Sense.

Do the following:

  1. In the QMC, from the Start menu, click License management.

    The License usage summary screen is displayed.

  2. Click the Professional access allocations tab.
  3. Click the + Allocate button.

    The Users screen is displayed.

  4. Select the users that you want to provide access to from the list and click Allocate.
    Information noteAllocate is disabled if the number of available allocations is insufficient for the number of selected users.

The users that you allocated access to appear in the Professional access allocations overview table.

Token-based license

Your Qlik Sense license includes a number of tokens that are used to allocate Qlik Sense access to users in your organization.

Do the following:

  1. In the QMC, from the Start menu, click License management.

    The License usage summary screen is displayed.

  2. Click the User access allocations tab.
  3. Click the + Allocate button.

    The Users screen is displayed.

  4. Select the users that you want to provide access to from the list and click Allocate.
    Information noteAllocate is disabled if the number of tokens available for allocation is insufficient for the number of selected users.

The users that you allocated access to appear in the User access allocations overview table.

Additional configuration

After you install Qlik Sense, you may wan to:

  • Create load balancing rules in the QMC to improve resilience and performance in a multi-node site. For more information, see Load balancing.
  • Configure the virtual proxy advanced settings to add your own hosts names to the white list. For more information, see Host white list.
  • Configure the user directory connector to retrieve users from a user directory. For more information, see User imports (UDC).

You are now ready to start using Qlik Sense. See: Get started.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!