Application Workspace Server is distributed as a Microsoft Installer (MSI) which you can find on our Downloads page.
This article provides the description of a few steps required to install it.
Prerequisites
Setting up an empty database prior to installing the Application Workspace Server for the first time is mandatory. If you choose to use an Azure SQL database and you want to configure Microsoft Entra ID (Azure AD) authentication for it, you need to install the SQL Server Native Client locally, otherwise this authentication method will not work. For more information, see Installing SQL Server Native Client and Configure and manage Microsoft Entra authentication with Azure SQL.
NOTE: Application Workspace Server is a web server and any existing services running on port 80 or 443 will cause conflicts.
To guarantee that the web version and Application Workspace Launcher of the Application Workspace work properly, a certificate supplied by Recast must be installed on the local PC. See HTTPS (Webserver certificates).
To install the first Application Workspace Server:
1. Run the setup wizard, clicking Next in the Intro, End-User License Agreement, and Custom Setup windows.
2. In the Service Account window, provide credentials for the Application Workspace Server Service, which will be used for database connectivity and/or for securing access to the Content Store.
You can choose to use Windows Authentication or insert your credentials.
If you provide custom logon account credentials, make sure that this account has local admin rights on the server as well as “Log on as a service” rights as described in Add the Log on as a service Right to an Account | Microsoft Learn.
3. In the Setup Database window, enter the database connectivity information to be used by the Application Workspace Server Service.
Supported authentication methods:
- Windows Authentication The Windows/Active Directory service account that has been configured in the previous step will be used to authenticate with the SQL database. Make sure that both the service account from the previous screen and the user account that runs the setup (for database schema creation) have permission to access the SQL Database.
- SQL Server Authentication Specify account credentials of an SQL user with SQL database permissions.
- Azure Active Directory - Password Specify account credentials of an Azure AD user with SQL database permissions.
- Azure Active Directory - Integrated The Azure AD service account that has been configured in the previous step will be used to authenticate with the SQL database.
4. In the Create zone window that opens if you provide an empty SQL database, specify the primary zone for your Application Workspace System, meaning the FQDN that will be used to access the Application Workspace System.
See also
First login: How to access Application Workspace using a web browser on the FQDN you provided for the first time
Server Configuration: Main configuration options for the server.json file
Content Store: How to relocate the content store (local data) to a different location
HTTPS (Webserver certificates): How to enable SSL
Load Balancing: Best practices for configuring the load balancing solution for multiple Application Workspace Servers within an Application Workspace System
