> For the complete documentation index, see [llms.txt](https://knowledgebase.qommentary.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.qommentary.com/getting-started/installation.md).

# Installing

When you're ready to install Qommentary, launch the Qommentary Setup Wizard as an administrator.

![](/files/-M4iFnVCmivkQYQujJ0Z)

1\.  Click on **I Agree** to accept the License Agreement

![](/files/-M4iGhehb1KinWZilWfk)

2\. Choose the install destination folder or leave as default

![](/files/-M4iGwljlyUlvtkFfXr9)

3\. Choose if you wishto install a local PostgreSQL database or connect to an existing instance

**Install local database**

![](/files/-M4iIBYIkZApUorwUnLS)

| Field            | Description                                         |
| ---------------- | --------------------------------------------------- |
| Hostname         | The database hostname. Uses *localhost* by default. |
| Port             | The database port number                            |
| User name        | The superuser name                                  |
| User password    | The superuser password                              |
| Confirm password | Confirm superuser password                          |

**Connect to existing instance**

![](/files/-M4iJk3qo9kfwxlEzM2c)

| **Field**     | Description                                                                     |
| ------------- | ------------------------------------------------------------------------------- |
| Hostname      | The database hostname. Uses *localhost* if Qommentary is hosted on same server. |
| Port          | The database port number                                                        |
| User name     | The superuser name                                                              |
| User password | The superuser password                                                          |

{% hint style="warning" %}
Make sure the database user credentials have superuser rights.
{% endhint %}

4\.   Enter details for your Qlik Sense environment

![](/files/-M4iK_5QAclfHx7TJo6q)

| **Field**        | Description                                     |
| ---------------- | ----------------------------------------------- |
| Protocol         | The Qlik Sense protocol name                    |
| Hostname         | The Qlik Sense hostname (FQDN)                  |
| Port             | The Qlik Sense port number                      |
| Prefix           | The Qlik Sense default virtual proxy prefix     |
| Certificate name | The Qlik Sense client certificate friendly name |

{% hint style="warning" %}
Make sure the Qlik Sense hostname can be resolved from the Qommentary server as well as any network client laptop.
{% endhint %}

5\. Enter details for the Qommentary components hosted in IIS

![](/files/-M4iWIFA7rYezXZN7gvc)

| **Field**          | Description                                                                                                                                                           |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Protocol           | The protocol used to access the Qommentary components                                                                                                                 |
| Same as Qlik Sense | Indicates whether Qommentary is being installed on same server as Qlik Sense                                                                                          |
| Hostname           | If previous option is unchecked, specify hostname/FQDN used to access the Qommentary components                                                                       |
| Certificate        | SSL certificate applied to the Qommentary components.                                                                                                                 |
| Username           | Local admin account to run the Qommentary Application Pool. Recommended to use a service account with access to certificate private keys in the Local Computer store. |
| Password           | Local admin account password                                                                                                                                          |
| Confirm password   | Confirm local admin account password                                                                                                                                  |

{% hint style="warning" %}
If an SSL wildcard certificate is available, please update each Qommentary component binding using the IIS Manager after installation.
{% endhint %}

6\. Enter details for Qommentary ports

![](/files/-M4iWeJJTa5VLD41auR_)

7\. Click on **Install**

![](/files/-M4iWoJEG-YMohdeaMeO)

8\. Once the installation has completed, you should see a confirmation screen

![](/files/-M4iWwpqthTMIPf82ojP)

{% hint style="info" %}
If any issues were encountered during installation, please refer to the [Troubleshooting ](broken://pages/-M4g6jGU7x0ZrX_RFO7S)section
{% endhint %}

9\. Click on **Launch Qommentary Manager** to open a new browser and activate your license