.. Reminder for header structure:
  Parts (H1)          : #################### with overline
  Chapters (H2)       : ******************** with overline
  Sections (H3)       : ====================
  Subsections (H4)    : --------------------
  Subsubsections (H5) : ^^^^^^^^^^^^^^^^^^^^
  Paragraphs (H6)     : """""""""""""""""""""

.. meta::
  :description: Quickstart - Installing WAPT Server on Windows
  :keywords: Quickstart,WAPT,Server,Install,Windows

.. |date| date::

.. role:: red

.. _quickstart_windows_server_install:

##########################################################
Quickstart - Installing the WAPT Server (WINDOWS for test)
##########################################################

******************
To read beforehand
******************

.. warning::

  Installing WAPT on a Linux server is the recommended method, unless you are trialing WAPT and you are not familiar with Linux. Due to a limitation of Nginx server on Windows, the maximum number of support agents on a Windows WAPTserver is 200 agents.

* The quickstart guide is designed to install WAPT Server on a Windows host.
  Installing WAPT on a Linux server is the :red:`recommended method`, unless you are trialing WAPT and you are not familiar with Linux.

* With WAPT Server Windows version some WAPT features can not be enabled, such as Kerberos authentication or uploading voluminous packages.
  The :program:`Nginx` web server performance is limited and less efficient on Windows, so WAPT actions will be slower.
  Please consider carefully this informations before installing the WAPT Server.

* The installation of the WAPT Server **MUST** be done using a :red:`Local Administrator` account on the host and **NOT a Domain Administrator** account.

* :program:`Nginx` is the **ONLY** supported web server with WAPT.
  **Apache or IIS (with or without WSUS) are NOT supported in WAPT**.

* In case of problems when installing WAPT, visit the :ref:`Frequently Asked Questions <wapt_faq>`.

.. danger::

  * The WAPT Server **MUST NOT** be installed on a computer with services already listening on port.
    :red:`Port 443 is used by the WAPT Server and MUST be available to WAPT only`.

  * The WAPT Server **will NOT run** on a x86 version of Windows.
    It runs only on a fresh :red:`Windows version currently supported by Microsoft`.
    The server component of WAPT works fine on a win10 or win11 client (VM or physical host).

**********************
Installing WAPT server
**********************

* Download and execute as Administrator, |waptserversetup_exe|.

* Choose the language for the WAPT installer and click on :guilabel:`OK` to go on to the next step.

* Accept the licence terms and click on :guilabel:`Next` to go to next step.

* Choose additional configuration tasks (leave the default if not sure).

.. figure:: wapt-resources/wapt_deploy_additional-configuration-server_dialog-box.png
  :align: center
  :alt: Choosing the installer options for deploying the WAPT Serer

  Choosing the installer options for deploying the WAPT Server

* Choose the password for the WAPT Server and click on the :guilabel:`Install` to launch the installation, wait for the installation to complete.

.. image:: wapt-resources/quickstart_wapt_deploy_choosing-password_dialog-box.png
  :align: center
  :alt: Dialog box for changing the password

* Click on :guilabel:`Finish` to close the window.

In :file:`gif` it looks like this :

.. image:: wapt-resources/waptserverexe.gif
  :align: center
  :alt: waptserver.exe

.. attention::

  * **For security, do not run the WAPT Console or your WAPT package development tool on the WAPT Server.**

  * The WAPT Server on Windows **includes the WAPT Agent**.
    It is not necessary to install the WAPT Agent to manage the WAPT Server on Windows.

Your WAPT Server is now ready.
You may now go to the Quickstart documentation on :ref:`installing the WAPT management Console <quickstart_install_wapt_console>`.

.. hint::

  If you want to use features such as Kerberos or to deploy voluminous packages, you will have to migrate your WAPT Windows Server to Linux or create a new one from scratch after your tests.
  Please note that above 500 agents, you will also have to migrate to Linux.