Client installation

The Lime CRM desktop client is distributed as a single installer application named limecrm-desktop-<version>.exe.

The installer will dynamically download and install dependencies, such as .Net Framework, MSVCRT and WebView2. See sections on External Dependencies and Common Issues below for hints how to prepare for trouble-free installation or upgrade.

To install Lime CRM, simply launch the installer and follow the instructions. The installation requires administrator privileges.

By passing command-line switches to the installer application it is possible to automate the installation in different ways. The following switches are available:

Switch Description
/install, /repair, /uninstall Installs, repairs or uninstalls the application.
/passive Shows the installer UI but does not require any user interaction during install.
/quiet Does not show the UI and no interaction necessary.
/norestart Suppress any attempts to restart the computer during installation. By default, the UI will prompt before restart.
/log <filename> Log to a specific file. By default, logs are created in the directory pointed to by the %TEMP% environment variable.

In addition to command-line switches the installer application accepts a number of property and value combinations that can be passed on the command-line after the switches mentioned above.

Property name Description
LIMELANGUAGE Default client language to use. Currently supported values are sv, en-us, fi, no, da and windows to use auto-detection.
LIMESERVER Default Lime CRM Server address to use. Do NOT include protocol prefix, e.g. "https://".
LIMEHTTPSPORT Default Lime CRM Server https port number to use.
LIMEDATABASE Default Lime CRM database name to use.
LIMEAUTOLOGIN Whether to show the login dialog or not on startup. Valid values are 1 (yes) or 0 (no).
DisableAutoUpdate Disables the autoupdate addin if set to 1.
LaunchLime Launches Lime as current user, non-elevated if set to 1 and installer is run in passive mode.
DisableUsageReport Disables the usage statistics and error reports if set to 1.

Executing the following will install the Lime CRM client in passive mode and use Swedish as the default language:

limecrm-desktop-xxyyzz.exe /install /passive LIMELANGUAGE=sv

The Lime CRM Desktop client is automatically kept up to date. Auto update is enabled by default in version 10.16 and up. Our recommendation is to use auto updates to make sure the Desktop client remains secure and as performant as possible.

If there are circumstances where auto updates are not suited or possible, it can be locked to certain versions or completely turned off.

Server side version lock

Locking the Lime CRM Desktop client to a specific version is supported for Lime CRM 11.x.1592 and later. This is achieved by configuring the Lime CRM servers application configuration as:

config:
    features:
      recommendedDesktopVersion: <version>

This setting can be used to limit the organisation to a specific version. When a new version should be rolled out the setting can be updated to the new wanted version.

The application configuration is supported for backend versions since May 2021. For existing backend installations the same feature can be enabled using database-level setting:

DELETE FROM [dbo].[setting] WHERE [name] = 'features.recommendedDesktopVersion'
INSERT INTO [dbo].[setting]
           ([type]
           ,[name]
           ,[datatype]
           ,[value]
           )
     VALUES
           (1
           ,'features.recommendedDesktopVersion'
           ,8
           ,'"11.1.2194"')

Update channel

Update channel is configured via a special option field in the coworker record. The field must be called updatechannel.

This setting can be used to select adoption rate for new releases per user or solution. The setting is supported by all current releases of Lime CRM Desktop. The field can be hidden and locked via SQL to enforce single channel for all users.

Valid values are:

  • rc - Release candidate, more frequent updates and early access to features and fixes. Updated when new build are available for external usage.
  • stable - Default (general recommendation). Updated approx 4 times per year.
  • mature - Less updates, longer delay for features and fixes due to extended validation process. Generally releases on stable will be promoted to mature after 4-6 weeks.

The stable channel is strongly recommended for cloud (*.lime-crm.com).

Generally the mature channel is recommended for institutional and complex self-hosted setups. For long-term stability this configuration should be coupled with internal verification of coming updates using Lime CRM Desktop (Insider) or rc- and stable- channels.

Client side disable

Strongly consider alternative options listed above before choosing this alternative. Completely disabling the automatic updates will require you to manually handle any and all future upgrades, including security related patches.

Auto updates can be completely disabled on the client side using the following methods.

  1. Disable the auto updater addin using the installer, see above.
  2. Disable the auto updater after installation using the registry.
  3. Disable the Lundalogik Maintenance Service using the registry (not recommended).

Notes:

  1. in the following a\b\key\@value syntax is used for registry entries.
  2. on 32-bit machines omit WOW6432Node from registry keys.

To disable the auto update addin:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Lundalogik\Lime\InstalledAddins\LimeAutoUpdate.Addin]
"LoadBehavior"=dword:00000000
"Mandatory"=dword:00000001
  1. Stop the addin from loading (current user): HKEY_CURRENT_USER\Software\Lundalogik\Lime\Addins\LimeAutoUpdate.Addin\@LoadBehavior should be set to 0 (DWORD)
  2. Stop the addin from loading (all user): HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Lundalogik\Lime\InstalledAddins\LimeAutoUpdate.Addin\@LoadBehavior should be set to 0 (DWORD) and HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Lundalogik\Lime\InstalledAddins\LimeAutoUpdate.Addin\@Mandatory should be set to 1 (DWORD)
  3. Load the addin but disable it (all users): HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Lundalogik\Lime\AutoUpdate\@Disabled set to 1

To disable the maintenance service (not recommended):

  1. Disable the service from running, set HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Lundalogik\Lime Maintenance Service\@Disabled to 1 (DWORD). This setting is also checked by the auto update addin.
  2. Disable the service itself, e.g. by setting its startup type to disabled using services.msc or the registry. Note that this service only starts if an update is available and thus never runs (and consumes resources) otherwise!

The Lime CRM client can also be deployed through, for example, Active Directory or Microsoft SCCM. In these cases it is usually preferable to use Windows Installer packages (.msi) to install the application. The Lime CRM installer application (.exe) contains embedded .msi files that can be extracted and deployed. Extraction can be done by following these steps:

  1. Download and install the WiX Toolset v3.
  2. Open a command prompt and run the following command:
    <wix install dir>\bin\dark.exe -x c:\temp\limepro <full path to limepro-xxyyyzz.exe>
  3. The extracted .msi files will be found in c:\temp\limepro\AttachedContainer

One of the extracted files will be LimeClientSetup.msi. This Windows Installer package accepts the same installer properties as the installer application. Note that the files must be deployed in the following order:

  1. LimeMaintenanceService.msi
  2. LimeClientSetup.msi

The LimeMaintenanceService.msi installer installs the Windows service responsible for updating the client. This install is not required, however, strongly recommended. Not installing this will disable auto-updating of the Lime CRM client.

To install/uninstall/reinstall an .msi package manually, use msiexec.exe.

Important: VBA is installed/updated via C:\Program Files (x86)\Lundalogik\Lime CRM\setupVBA.exe, which is included in the installer, but must be launched separately due to nested MSIs.

If you want to deploy the Lime CRM Client via Intune/Microsoft Endpoint Manager you can do it two different ways.

Install with the exe you provide.

If you choose to go this route you provide the exe to the customer who then packages the app as an .intunewin-application using the Win32 content preptool and then publish the application in Intune/Microsoft Endpoint Manager as a win32-appplication. Note that this option is pretty limited when it comes to install-arguments.

Install the latest available exe with powershell/win32

Provide the customer with this powershell-script (LimeClient.ps1) and ask them to package the powershell-script as an .intunewin-application using the Win32 content preptool and then publish the application in Intune/Microsoft Endpoint Manager as a win32-appplication.

Stop-Transcript

$ErrorActionPreference = 'Stop'
$VerbosePreference = 'Continue'
$ProgressPreference = 'SilentlyContinue'

New-Item -ItemType Directory -Force -Path "C:\Automation\Logs" -ErrorAction Ignore
Start-Transcript -Path "C:\Automation\Logs\install-limecrm-desktop-stable-$(get-date -f yyyyMMddHHmmss).txt"

Write-Verbose "Download latest version"
$url = "https://builds.lundalogik.com/api/v1/builds/limecrm-desktop/versions/latest/file/?tag=released"
$installer = "$env:temp\limecrm-desktop-stable-latest.exe"
Invoke-WebRequest -Uri $url -OutFile $installer -UseBasicParsing

Write-Verbose "Download complete, install"
$arguments = "/install /quiet /norestart /l c:\automation\logs\install-limecrm-desktop-stable-installer.txt"
Start-Process $installer -ArgumentList $arguments -Wait

Write-Verbose "Installation complete, delete installer"
Remove-Item $installer -ErrorAction Ignore

Write-Verbose "All done."

Stop-Transcript | Out-Null

Exit 0

Microsoft Endpoint Manager settings for Lime CRM Client as a win32-application

Install Command

c:\windows\System32\WindowsPowerShell\v1.0\powershell.exe -ExecutionPolicy bypass -WindowStyle hidden -File .\LimeClient.ps1

Uninstall Command

powershell.exe

Detection Rule

Manually configure detection rules (Type: File) %ProgramFiles(x86)%\Lundalogik\Lime CRM

When installing the Lime CRM client in a multi-user environment, for example, Terminal Services/Remote Desktop Services/Citrix, make sure to log on as a user with administrator privileges and install Lime CRM through Control Panel | Add/Remove Programs.

Download and pre-install these dependencies for controlled environments or offline installation:

Typical scenarios where this is necessary:

  • No or limited Internet access
  • Customer IS/IT must approve each individual installer
  • Environment require specific versions of required components

Outlook integration

In order to make the Outlook integration work correctly, Lime CRM and Outlook have to run on the same client. If Lime CRM is to be run as a published application, the host system must be configured so that Lime CRM and Outlook are started in the same session.

Microsoft Office 2007 or later.

  • Last modified: 8 weeks ago
  • by Pontus Netler