====== Server installation ======
This page describes how to perform a new installation of Lime CRM Server. For performing an upgrade, please refer to the [[installation:upgrades|upgrade page]] instead.

===== Preparations =====
Before beginning the installation, make sure to carefully read and act on the below information.

==== Required software ====
Prepare the Windows server environment by installing the Microsoft .NET 4.7.2 Framework or later unless its already installed.

<WRAP round info>
**Python 3.11 is required from version 2023.1 (Hvannadalsnjúkur)**

From version 2023.1 and later of Lime CRM Server, Python 3.11 needs to be installed prior to installation or upgrade of Lime CRM Server.

Instructions for how to install Python 3.11 is found [[installation:python311|here]].

</WRAP>

<WRAP round info>
**Python 3.7 is required from version 12.51 to 2022.3 (Rysy)**

From version 12.51 and later of Lime CRM Server, Python 3.7 needs to be installed prior to installation or upgrade of Lime CRM Server.

Instructions for how to install Python 3.7 is found [[installation:python37|here]].

</WRAP>

==== Users and groups ====
The installer asks for:

  * A dedicated service user to run Lime CRM Server services. This can be a local or AD user. The user must be the database owner of all Lime CRM related SQL Server databases and if databases are to be created using LISA, the user also needs SQL Server //create database// permissions.

  * A local or AD group to contain all users allowed to access LISA, for example //Lime CRM Admins//.

==== Network access ====
By default, Lime CRM Server listens for incoming connections on the standard https port, 443 (tcp), which may be changed during installation. Lime CRM Desktop Client and Lime CRM Web Client use the same port to connect to Lime CRM Server. Firewalls must be configured to allow incoming traffic on the selected port on the machine where Lime CRM Server is installed. The Lime CRM Desktop Client communicates with Lime CRM Server using TLS 1.2.

If access to Lime CRM Server over the public Internet is desirable, using a [[https://en.wikipedia.org/wiki/Reverse_proxy|reverse proxy]] and/or placing the machine hosting Lime CRM Server in a [[https://en.wikipedia.org/wiki/DMZ_(computing)|DMZ]] may be a good solution.

==== Certificates ====
The installer asks for an HTTPS certificate to use for Lime CRM Server. Use an existing certificate issued by a trusted root certificate authority. The certificate must be located in the Windows Certificate Store (machine store) and have a private key that is marked as exportable. Certificates issued using a CNG cryptography provider (Microsoft specific) are not supported.

===== Installation procedure =====
Lime CRM Server is distributed as a single installer application named ''limepro-server-<version>.exe''. Perform the installation by launching the installer and following the on-screen instructions.

<WRAP round info>
=== Note! ===
To enable single sign on, [[configuration:sso|additional configuration]] is required.
</WRAP>

==== Programs and services installed ====
During the installation, the following programs and services will be installed:

Lime services (2023.1):
  * Lime CRM Event Handler (lime-event-handler)
  * Lime CRM Import Service 1 (lime-crm-importer-1)
  * Lime CRM Scheduler (limecrm-scheduler)
  * Lime CRM Search Indexer (lime-crm-search-indexer)
  * Lime CRM Server Administration (llab-lisa)
  * Lime CRM Task Scheduler Service (lime-task-scheduler)
  * Lime CRM Task Service 1 (lime-task-handler-1)
  * Lime CRM Webfront (lime-crm-webfront)
  * Lime CRM Webserver (lime-crm-webserver)

Lime Component Services (2023.1)
  * COM+ Applications -> Lundalogik Data Components

Lime services (<=2022.3):
  * Lime CRM Server
  * Lime CRM Import Service
  * Lime CRM Search Indexer
  * Lime CRM Scheduler
  * Lime CRM Event Handler
  * Lime Task Scheduler Service
  * Lime Task Service
  * LDC
  * LISA

Programs/services installed and used by lime: 
  * Erlang
  * RabbitMq
  * Sql Native Client
  * Elastic Search
  * Nginx
  * vcredist_x86.exe

===== Python customizations =====
For developing and deploying modern customization using Python, you will need to create a ''solution''. For more on solutions, see the [[https://platform.docs.lime-crm.com/en/latest/getting-started/concepts/?h=solution#solution|Platform Documentation]].

===== Troubleshooting =====
The installation will generate log files in ''%userprofile%\AppData\Local\Temp''. These are named ''limepro_install_<timestamp>.txt'' for the main installation, and ''<component>.msi.install.txt'' for the installation of related components.