Server installation

This page describes how to perform a new installation of Lime CRM Server. For performing an upgrade, please refer to the upgrade page instead.

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

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

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 here.

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 here.

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.

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 reverse proxy and/or placing the machine hosting Lime CRM Server in a DMZ may be a good solution.

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.

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.

Note!

To enable single sign on, additional configuration is required.

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

For developing and deploying modern customization using Python, you will need to create a solution. For more on solutions, see the Platform Documentation.

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.

  • Last modified: 19 months ago
  • by Anders Edqvist