Deploy Workspace desktop app with preconfigured Devolutions Server

This guide covers the steps to deploy Workspace desktop app with a preconfigured Devolutions Server. 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.

   param(
       [string]$DVLS_SERVER_URL = "<your-server-url>"
   )
   
   try {
       $appDataPath = [System.Environment]::GetFolderPath('ApplicationData')
       $configDirPath = Join-Path $appDataPath 'net.devolutions\Workspace'
       $configFilePath = Join-Path $configDirPath 'Config.cfg'
       $logPath = Join-Path $configDirPath 'CreateConfigLog.txt'
   
       if (-not (Test-Path $configDirPath)) {
           New-Item -Path $configDirPath -ItemType Directory -Force | Out-Null
       }
   
       Add-Content -Path $logPath -Value "`n[$(Get-Date -Format 'u')] Starting config file creation..."
   
       $configContent = @{
           hubs = @();
           dvls = @(
               @{
                   name = 'Devolutions Server';
                   serverUrl = $DVLS_SERVER_URL;
                   serverVersion = '<your-server-version>';
               }
           );
           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. A Devolutions Server space is created.

6. Open the space and connect to it.

7. The space is now configured.

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

To do this, include the data source in your MSI command: msiexec /i "installer.msi" DVLS_SERVER_URL=https://dvlsurl.com