Installation Guide
  • Updated on 17 Feb 2020
  • 1 minute to read
  • Print
  • Dark

Installation Guide

  • Print
  • Dark


The following document is a walkthrough to installing the Decisions Platform on an App Server or PC. Decisions requires a database and in this guide, we will use SQL Server.

For recommended Installation Requirements please visit this article:  Installation Requirements - Self-Hosted Environment.
Do not have the Services dialog open during installation otherwise an error could occur.

Installing Decisions

-Microsoft SQL Server Express is suitable and the easiest to get started. It can be downloaded here

-Then navigate to the release site to open the installer:

Open the installer executable to begin the installation wizard.

In the first step - Installation Type - click the Install button.

After reading the license agreement, select the I accept the terms of the License Agreement check box and click the Next button.


Next, in the Select Installation Type step, we choose a type that fits our needs (in this case Personal Server ).

Below is a description of when each type would be used:

Standard ServerThis is the most common type of server installation and can be used in production (live) or non-production (development) settings. Use this server type when you want to be able to log into the server from other machines, to allow others to log into the server (for example, for QA cycles), and to publish your flows.
Personal ServerThis server type is strictly a local installation. Use this server type when you want to build and test Flows, Forms, Rules, Reports, and Pages, but you do not intend to publish them. This server type also does not let other machines log on.
Failover (HA) ServerThis server type is identical to the Standard Server except that it is not live until it is triggered. Use this type to install a failover server that will be available but will not run jobs or events on startup.
Designer RepositoryThis server type stores entities and manages versioning. It does not run live applications.


To configure advanced settings during your installation, select the Show Advanced Settings checkbox or, clear the checkbox to install Decisions OS with a standard configuration.

Select the desired options:

Use Settings FileEnables a field in which you can select a file of saved settings from a previous installation
Install Emergency Password Reset Toolinstalls a command-line tool that can be used to reset user passwords in Decisions.
Change Default System Administrator, Username and Passwordoption to change default Decisions “”: admin” credentials.
Change Destination Folder for InstallationBy default, the Decisions software is installed to C:\Program Files\Decisions. If desired, change this location by enabling this setting and browsing to the desired installation location.
Pick Alternate SourceEnables either a URL or directory to select for the installer files.
Install Extra IconsEnabling this setting installs the image library of icons available for use (which can be used as icons for items posted to the Service Catalog, for example, or to represent published workflows) Images are installed to C:\Program Files\Decisions\Images by default.
Show the Service SettingsEnabling this setting makes it possible to customize the user name/password under which the Service Host Manager Service will run.
Allow Dynamic Resource Loading (Local Module)allows system to store and load sources from Local Module.
Run Service Host Manager Watcher after InstallationIf enabled, the Host Manager Watcher service will run after installation. This is the process that can start and stop the 'Service Host Manager' that the Portal depends upon, as well as watches and restarts it if it stops for any reason.
Skip DB Connection Testing (Not Recommended)skipping database connection test in Installation wizard.
Dynamic Compression (IIS) Check Disabled (Not Recommended)disables installer to checkIIS Compression.


Click the Next button

Under Database Setup, Database Type , select the MS SQL option. Under the Connection Type , select Basic or Custom Connection String and fill in the DB Server and DB Database fields with the server location and name of the database.

If the database does not exist, Decisions OS will attempt to create it. To test these connection settings, click the  Test button.

Under Connection Settings , choose the option for Windows Integrated Security to enable database connection authentication using Windows Integrated Security, or MS SQL Server Security to enable database connection authentication using a specified username and password.


To learn more about difference between Windows Integrated Security and MS SQL Security please visit this article: SQL Server Database Permissions

To continue installation, click Next .

Fill in the Base Url field with the URL where users will go to access the portal.  To redirect all requests for the root host to the portal URL, select the Redirect Root http(s) requests to Base URL above checkbox.

For more information on Installing to Root view:


Click Next

In the Web Application screen, under Web Site , select the site in IIS under which Decisions will install.

Also, select desirable Application Pool.

Click Next

For many standard features to work, Decisions OS requires access to a mail server with which it can send email.

To configure a connection to an SMTP server, select the SMTP Server option and fill in the required connection fields. To configure this connection later, or to configure Decisions OS to look for an SMTP server running on the local machine, select SMTP Direct Server.

Click Next

In the Encryption Keys window we can restore database encryption keys from the file.

Click Next

The account that is provided here must have proper rights to run as a service.

To add these rights, go to Administrative Tools > Local Security Policy > Local Policies > User Rights Assignment.

Edit the item "Log on as a service" and add your domain user.

Finally, the installer will automatically perform tests of the installation environment to ensure that it meets the operational requirements to run Decisions.

When all of the system requirement checks have successfully completed, click the Next button.

The installer will list the configuration settings for this installation.

In the event a reinstallation or recovery, save these installation settings for future reference by selecting the Save Installation Settings to File checkbox.

Click the Next button.

As part of the process, the installer will automatically download, register, and configure any required third-party services or utilities.

As this is happening, you may click the Show Details and Hide Details buttons to toggle a report of what's happening behind the scenes.
When the installation is complete, the installer displays a completion message.

Click the Finish button to close the installer and open portal. Use the administrative credentials that are provided on the screen to log into the portal.


After clicking Finish you will be redirected to the login page.

If Decisions was installed on local machine we can see localhost/decisions/... in the browser address bar.

If using a different address to install the Portal then something similar to would be in the browser address bar. 

After so, click Login which will redirect to the Portal Home page

For the HTML Portal, you must open the port configured in settings for SignalR and the next port after that

Updating the license

License Utility- Computers can be licensed to run the platform with third-party plugins or with the built-in licensing mechanism.

To license a machine using License Utility, open the executable and email the Machine Key it generates to ""

The tech support team will respond with a license key that can be copy and pasted into License Utility and applied to generate a license key file.

Our example assumes that the platform has been installed in the default path.

  • To access the license utility, navigate to the folder C:\Program Files\Decisions\Decisions Services Managerlicensing.
  • Run the LicenseUtility.exe. The License Utility dialog box appears.


License Utility generates a unique string for this machine in the Machine Key field.

  • Select the string in the Machine Key field and copy it to your clipboard.
  • Paste the machine key into an email and send it to your contact for generating licenses.

Using the machine key you've provided, your license key will be generated and provide it to you.

  • When you receive the license key, in the License Utility, paste the license key into the License Key field.
  • Click the Apply button.


A pop-up alert will notify you when your license key is due to expire.

Click OK.

After updating the license, restart the Service Host Manager.

For other database options, see the Advanced Installation documentation category. Begin here:
Was this article helpful?