Create a Devolutions Server instance

If you have recently received your serial license keys, please refer to Getting started.

For more information about any of the features in the deploy wizard, please consult their respective topic under Server Settings.

Multiple Devolutions Server instances can be hosted on the same server. Each instance resides in its own web application within IIS. The following steps are carried out using the Devolutions Server Console and are also valid for the free edition of Devolutions Server.

First steps

  1. Install Devolutions Server Console on the web server. It is available from the Download page.

  2. Execute Devolutions Server Console with elevated privileges (run as administrator). This is performed by right-clicking on the application and selecting Run as administrator.

    All operations performed through the Devolutions Server Console are done with the credentials used to launch Devolutions Server Console. If you must use other credentials, you will need to launch another Windows session. The RunAs command does not offer the option of starting a process with elevated privileges. The Run as different user option can work only if the account is a member of the server's local administrator group.

    Run as administrator
    Run as administrator

  3. In the Devolutions Server Console, click on the New button or the Install New Instance button to deploy a new server instance using the basic installation or the advanced installation wizard. It is also possible to Migrate SQL Data Source.

    Deploy a new Devolutions Server
    Deploy a new Devolutions Server

Basic installation

  1. If a SQL Server instance is not available on the machine where Devolutions Server is hosted, a SQL Server Express edition instance will be installed by the wizard. An internet connection is required to download the SQL Server Express edition and the following prerequisites: IIS Application Request Routing (ARR), IIS Rewrite Module, and ASP.NET Core Module (ANCM).
    Basic installation dialog
    Basic installation dialog
  2. The following dialog provides the credentials created for the sa SQL account, the Devolutions Server administrator account and the Encryption Key password. Click on the Save As button to save the information in a file.
    Important credentials dialog
    Important credentials dialog
  3. The following dialog displays the SQL Server information, including the sa account credentials, that will be used by Devolutions Server to create and connect to the SQL database.
  4. Once the installation is successfully completed, the wizard will display the installation summary and will automatically open the default browser to connect on the Devolutions Server web interface.
    Installation summary report
    Installation summary report
  5. On the Devolutions Server web interface, use the credentials provided in step 2 to log in. Afterward, a prompt will request a password change before continuing with the login process.
    Change your password prompt
    Change your password prompt
  6. Enter your license. To activate the free edition, click the Activate the Free Version button to immediately access Devolutions Server with a free license.

Advanced installation

  1. For the first step, the installation wizard will run diagnostics on the server to verify if the IIS Server has all the necessary web server prerequisites installed and is ready to run Devolutions Server. Missing features are marked with an error icon. The Install Prerequisites button will install all missing features using a PowerShell script.Click on Close to continue. An internet connection is required for IIS Application Request Routing (ARR), IIS Rewrite Module and ASP.NET Core Module (ANCM).

    IIS Features Diagnostic
    IIS Features Diagnostic

  2. The License Agreement needs to be accepted to proceed.

    Devolutions Server End User License Agreement
    Devolutions Server End User License Agreement

  3. Under Database, enter the server and database information. The user account used to create the database must have sysadmin privileges in the SQL Server instance. Consult Database for more information. To use Windows Authentication to connect to the database, it is important to change the Application Pool Identity in the IIS Manager and set the proper permission of the service account on the SQL database. Please consult Configure Devolutions Server to use domain single sign-on (SSO). The following article about Pre-Deployment Account Survey describes which accounts that can be created prior to deploy Devolutions Server.

    Database dialog
    Database dialog

  4. Under General, enter a custom Name and Description. Under Serial, provide a license serial that has been received by email upon buying the product. If you did not buy any Devolutions Server license yet, you may Request a 30-days trial or continue without a license to use Devolutions Server Free for up to 10 users. You will be prompted on Devolutions Server first launch to Activate the Free Version.

    General and registration dialog
    General and registration dialog

  5. Under Installation Source, select to either Download from the web (latest version) or Install from zip file available from the Download page.

    Source dialog
    Source dialog

  6. Under General, select the Website, Web Application Name and Access URI required to reach the Devolutions Server web page. Under Installation Destination, set the Installation Folder where the instance's files will be located. The process to run Websites has been granted the proper permissions under C:\inetpub\wwwroot. We recommend to create a new folder beneath it and create the Devolutions Server instance within this folder. Under Application Pool, set the Application Pool Name.

    We do not recommend to set the installation folder to C:\Program Files or C:\Program Files (x86). Devolutions Server is a web application and this could result in unwanted behavior and issues because IIS do not have enough permissions to run web applications that are located under those folders. If you want to set the web application folder in a location different than the default C:\Inetpub\wwwroot folder, the IIS_IUSRS built in local machine group will need Read and Read & Execute permissions on the entire Devolutions Server web application folder structure.

    Destination dialog
    Destination dialog

  7. Under Administration Credentials, fill in the information to create a Devolutions Server Custom administrator account. All fields are required.

    Create An Administrator User
    Create An Administrator User

  8. Under Scheduler Service, when enabling the Install Scheduler service option, please set the proper Service Account. The following features depend on the Scheduler: Backup manager, Domain Users and Users Groups cache, Office365 Users and User Groups cache, Email notifications, Cleanup Logs and Privileged Access Management.

    Scheduler dialog
    Scheduler dialog

  9. Choosing to not install the Scheduler, you will get the following warning message.

    Scheduler warning
    Scheduler warning

  10. Under Recovery Kit, select the destination folder and file name of the Devolutions Server recovery kit file. Set a password to protect the Encryption Keys. If the Include sensitive data option is enabled, the SQL authentication credentials will be included in the recovery kit.

    We recommend to protect the Recovery Kit file in a safe place to avoid data loss if Devolutions Server has to be restored.

    Backup the encryption keys
    Backup the encryption keys

  11. Under Summary, validate the configuration and click Install.

    Summary dialog
    Summary dialog

  12. Once the installation is complete, a summary indicates if the Devolutions Server has been deployed correctly, click OK to close this window.

    Installation progress
    Installation progress

Test the installation

To test the server installation, navigate to it (e.g.: http://<Machine_Name>/) with any web browser or click on the Navigate to Website button in the Devolutions Server Console.

Devolutions Server Console
Devolutions Server Console

In some situations, the web page may not load properly. Ensure that the IIS IUSRS local built-in group has full read access on the encryption.config file located in the App_Data sub folder located in the Devolutions Server web application folder (i.e., C:\inetpub\wwwroot\dvls\App_Data). If there is still an issue, contact us at service@devolutions.net.

To test the connection from a client by creating a data source in Remote Desktop Manager. Please consult Configure a client data source for more information.

Give us Feedback