Deploy Workspace desktop app with preconfigured Devolutions Server and Devolutions Hub Business

This guide covers the steps to deploy Workspace desktop app with preconfigured Devolutions Server and Devolutions Hub Business. Installation is handled through a RMM, followed by a PowerShell script to generate the necessary configuration file.

1. Install Workspace desktop app using an RMM.

2. Execute the following PowerShell script after replacing the variables with your data.

   #Requires -RunAsAdministrator
   
   param(
   
       [string]$DVLS_SERVER_URL = $null,
   
       [string]$HUB_NAME = $null,
   
       [string]$ORGANIZATION_ID = $null,
   
       [string]$PROVIDER_ID = $null
   
   )
   
   try {
   
       $appDataPath = [System.Environment]::GetFolderPath('ApplicationData');
   
       $configFilePath = Join-Path $appDataPath 'net.devolutions\\Workspace\\Config.cfg';
   
       $logPath = Join-Path $appDataPath 'net.devolutions\\Workspace\\CreateConfigLog.txt';
   
       if (-not (Test-Path (Split-Path $configFilePath))) {
   
           New-Item -Path (Split-Path $configFilePath) -ItemType Directory -Force;
   
       }
   
       Add-Content -Path $logPath -Value 'Starting config file creation...';
   
       $hubsList = @()
   
       if ($HUB_NAME) {
   
           $hubsList += @{
   
               url = "https://$HUB_NAME.devolutions.app";
   
               organizationId = $ORGANIZATION_ID;
   
               providerId = $PROVIDER_ID;
   
           }
   
       }
   
       $dvlsList = @()
   
       if ($DVLS_SERVER_URL) {
   
           $dvlsList += @{
   
               name = 'Devolutions Server';
   
               serverUrl = $DVLS_SERVER_URL;
   
               serverVersion = '2024.3.0.0';
   
           }
   
       }
   
       $configContent = @{
   
           hubs = $hubsList;
   
           dvls = $dvlsList;
   
           preventStartup = $true;
   
       };
   
       $json = $configContent | ConvertTo-Json -Compress;
   
       Add-Content -Path $logPath -Value "Config content created: $json";
   
       Set-Content -Path $configFilePath -Value $json;
   
       Add-Content -Path $logPath -Value "Config file created successfully at $configFilePath";
   
   }
   
   catch {
   
       Add-Content -Path $logPath -Value "Error creating config file: $_";
   
       exit 1;
   
   }
   

3. The script will generate a configuration file in the user AppData folder. For example:

   C:\Users\USERNAME\AppData\Roaming\net.devolutions\Workspace\Config.cfg

4. Launch Workspace desktop app.

5. Devolutions Server and Devolutions Hub Business spaces are created.

6. Open the spaces and connect to it.

7. The spaces are now configured.

When deploying Workspace desktop app using the MSI installer, you can add a Devolutions Server or a Devolutions Hub Business data source by providing it as an argument during installation.

• Devolutions Server: msiexec /i "installer.msi" DVLS_SERVER_URL=https://dvlsurl.com

• Devolutions Hub Business: msiexec /i "installer.msi" HUB_NAME=workspace ORGANIZATION_ID=devolutions PROVIDER_ID=devolutions