Product documentation
Citrix SecurSpaces™
View PDF

Prepare a Hyper-V VM

September 24, 2026
Contributed by: 
C

This page creates the Ubuntu VM on Microsoft Hyper-V that Citrix SecurSpaces™ is installed on. The Windows host can also run the installer. When the VM is ready, continue with Install on a local VM.

Prerequisites

  • A Windows edition with Hyper-V enabled, for example Windows 11 Pro.
  • Enough free memory on the host for a fixed allocation that matches your machine capacity. See Sizing.
  • Free disk space for the virtual disk and checkpoints.
  • An Ubuntu 22.04 or 24.04 Desktop ISO from Ubuntu releases.
  • To run the installer on the Windows host: Docker Desktop running Linux containers.

Create the VM

  1. In Hyper-V Manager, select your local host.
  2. Select New > Virtual Machine, and enter a name, for example SecurSpaces-Lab.
  3. Select Generation 2.
  4. Set Startup memory to the memory for your machine capacity, for example 16384 MB for Small. Clear Use Dynamic Memory for this virtual machine.
  5. Connect the network adapter to Default Switch. To reach the console from other devices, connect it to an external virtual switch instead.
  6. Create a virtual hard disk for your machine capacity, for example 200 GB for Small.
  7. Select the Ubuntu Desktop ISO as the boot image, and finish the wizard.
  8. Open the VM’s Settings:
    • In Processor, set the number of virtual processors for your machine capacity, for example 4 for Small.
    • In Security, keep Enable Secure Boot selected, and select the Microsoft UEFI Certificate Authority template.
  9. Start the VM, select Connect, and install Ubuntu Desktop. Create a user account with sudo permissions.
  10. Shut down the VM, remove the ISO from the DVD drive, and start the VM.

Tip:

Deleting a VM in Hyper-V does not delete its VHDX. When you repeat the installation, create a new virtual disk.

Prepare the guest

In a terminal on the VM:

  1. Install and enable SSH and curl:

    sudo apt update
sudo apt install -y openssh-server curl
sudo systemctl enable --now ssh
<!--NeedCopy-->

  2. Install the Hyper-V tools for the running kernel, and start the KVP daemon, so that Hyper-V reports the VM’s IP address:

    sudo apt install -y "linux-cloud-tools-$(uname -r)"
sudo udevadm control --reload-rules
sudo udevadm trigger --action=add --subsystem-match=misc
sudo systemctl enable --now hv-kvp-daemon
<!--NeedCopy-->

  3. Stop the VM from suspending when idle:

    sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target
<!--NeedCopy-->

  4. Note the VM’s IP address:

    hostname -I
<!--NeedCopy-->

  5. From PowerShell on the Windows host, check that you can connect:

    ssh <user>@<vm-ip>
<!--NeedCopy-->

  6. To keep a clean restore point, shut down the VM and create a checkpoint.

The VM is running, clean and reachable.

Run later steps from Windows

When you run the installer on the Windows host, use these PowerShell commands in the later steps.

  1. Run the installer:

    New-Item -ItemType Directory -Path "$env:USERPROFILE\SecurSpacesInstaller"
Set-Location "$env:USERPROFILE\SecurSpacesInstaller"
docker run --rm -it `
  --mount "type=bind,source=$($PWD.Path),target=/strong-network/shared" `
  strongnetwork/strong_installer:<version>
<!--NeedCopy-->

  2. Copy the deployment script to the VM:

    scp .\deploy.sh <user>@<vm-ip>:~/deploy.sh
<!--NeedCopy-->

  3. Check DNS and HTTPS:

    Resolve-DnsName <name>.try.sds.citrix.com
curl.exe --head https://<name>.try.sds.citrix.com/
<!--NeedCopy-->

  4. After a restart, check the VM’s state and IP address, in PowerShell as administrator:

    Get-VM -Name SecurSpaces-Lab
Get-VMNetworkAdapter -VMName SecurSpaces-Lab | Select-Object -ExpandProperty IPAddresses
<!--NeedCopy-->

Troubleshooting

Issue Resolution
The VM does not start, with error 0x800705AA Hyper-V cannot allocate the memory. Free memory on the host by closing applications or other VMs.
Hyper-V shows no IP address for the VM Install linux-cloud-tools-$(uname -r) and start hv-kvp-daemon. The generic linux-cloud-tools-virtual package can match a different kernel.
The AVX check fails on the guest The host CPU does not support AVX. Use a compatible host.
The installer container does not start Make sure Docker Desktop is running Linux containers and can reach Docker Hub.
The platform URL resolves to the wrong address The VM’s address on the Default Switch changed. Compare hostname -I with the DNS record.
Other devices cannot reach the console The Default Switch is reachable from the Windows host only. Use an external virtual switch.

Next step

Continue with Install on a local VM.

Prepare a Hyper-V VM
September 24, 2026
Contributed by: 
C
September 24, 2026
Contributed by: 
C

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.