((//////
#######//////
##########(/////.
#############(/////,
#################/////*
#######/############////.
#######/// ##########////
#######/// /#######///
#######/// #######///
#######/// #######///
#######//// #######///
########////// #######///
###########////#######///
####################///
################///
*#############///
##########///
######(*
~Parsec Self Hosted Cloud Setup Script~
This script sets up your cloud computer with a bunch of settings and drivers to make your life easier.
It's provided with no warranty, so use it at your own risk.
Home users who want to experiment with creating their own cloud server to play games.
If you are an IT person or business owner who is looking to roll out Parsec enabled cloud desktops for your business, you must license a Parsec Teams subscription.
- Set up your GPU accelerated cloud machine on Microsoft Azure, Amazon AWS, Google Cloud or Paperspace.
- Azure, AWS, Google: Log in via RDP and make note of the password - you'll need it later - Paperspace: Connect via Paperspace web app.
- Open Powershell on the cloud machine.
- Copy the below code and follow the instructions in the script - you'll see them in RED
Do not select "Turn on Display Device" when setting up the instance, this will cause you to have a display that cannot be removed. Parsec can't use this display and you will need to start again from scratch if you create an instance with that option enabled.
[Net.ServicePointManager]::SecurityProtocol = "tls12, tls11, tls"
$ScriptWebArchive = "https://github.com/parsec-cloud/Parsec-Cloud-Preparation-Tool/archive/master.zip"
$LocalArchivePath = "$ENV:UserProfile\Downloads\Parsec-Cloud-Preparation-Tool"
(New-Object System.Net.WebClient).DownloadFile($ScriptWebArchive, "$LocalArchivePath.zip")
Expand-Archive "$LocalArchivePath.zip" -DestinationPath $LocalArchivePath -Force
CD $LocalArchivePath\Parsec-Cloud-Preparation-Tool-master\ | powershell.exe .\Loader.ps1
This tool supports:
Server 2016
Server 2019
AWS g3.4xLarge (Tesla M60)
AWS g2.2xLarge (GRID K520)
AWS g4dn.xLarge (Tesla T4 with vGaming driver)
AWS g4ad.4xlarge (AMD Radeon Pro V520)
Azure NV6 (Tesla M60)
Paperspace P4000 (Quadro P4000)
Paperspace P5000 (Quadro P5000)
Google P100 VW (Tesla P100 with Virtual Workstation Driver)
Google P4 VW (Tesla P4 with Virtual Workstation Driver)
Google T4 VW (Tesla T4 with Virtual Workstation Driver)
Only use RDP to intially setup the instance. Parsec and RDP are not friendly with each other.
On AWS EC2 you can populate the instance userdata and the machine will automatically be provisioned as a team machine. Each value must be seperated by : as shown in the example.
Available arguments:
[type: string]key= (required)
[type: string]team_id= (required)
[type: string]name= (name of the host as you want it to appear in Parsec)
[type: int]team_group_id= (group id of the group you want to assign this computer to)
[type: int]user_id= (user id of the user you want to assign this computer to)
[type: string]user_email= (email address of the user you want to assign this computer to)
[type: boolean]is_guest_access= {true or false} (if you want this machine to have guest access enabled)
example: team_id=1234:key=5678:name=mycoolhost:user_email=person@company.com:is_guest_access=true
Q. Stuck at 24%
A. Keep waiting, this installation takes a while.
Q. My cloud machine is stuck at 1366x768
A. Make sure you use GPU Update Tool to install the driver, and on Google Cloud you need to select the Virtual Workstation option when selecting an NVIDIA GPU when setting up an instance.
Q. My Xbox 360 Controller isn't detected in Windows Server 2019
A. You will need to visit Device Manager, and choose to Automatically Update "Virtual Xbox 360 Controller" listed under the Unknown Devices catagory in Device Manager.
Q. I made a mistake when adding my AWS access key or I want to remove it on my G4DN Instance
A. Open Powershell and type Remove-AWSCredentialProfile -ProfileName ParsecGPUUpdate - This will remove the profile from the machine.
Q. What about GPU X or Cloud Server Y - when will they be supported?
A. That's on you to test the script and describe the errors you see, do not create an issue in Github that does not contain an issue. Do not create an issue without any actual diagnosis information or error messages.
Q. How do I change my wallpaper?
A. Delete the Wallpaper registry value from HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\System
Q. I created an Amazon AMI using this script but when I create a machine from the AMI I can't select high display resolutions above 1366x768
A. You didn't create the AMI correctly. You should search for "Run Sysprep with EC2Launch" on this page. It's important when using the tool, you select"
Shutdown with sysprep". When the instance has shutdown/stopped after running the AWS tool, then you can create the image. If you must turn on the instance again, you should run the sysprep tool again and shutdown.
Q. I connect to my cloud machine with Parsec and see a Parsec logo on the desktop, and the Windows Task bar, but when I click icons in the task bar, nothing happens.
A. There is another screen on the cloud machine that Parsec can't capture, that is set to your default/primary display. Do the following to switch the primary display to the screen that Parsec can capture.
- Connect to the host via Parssec
- Press CTRL + Shift + i (this will enter into immersive mode)
- Press Windows Key + P
- Press Down Arrow, Down Arrow, Enter.
Q. I want to run this script automatically without user interraction.
A. It's possible to do so but you will need to figure out how to install the GPU Driver on your own. The below code will do everything but install the GPU Driver.
[Net.ServicePointManager]::SecurityProtocol = "tls12, tls11, tls"
$ScriptWebArchive = "https://github.com/parsec-cloud/Parsec-Cloud-Preparation-Tool/archive/master.zip"
$LocalArchivePath = "$ENV:UserProfile\Downloads\Parsec-Cloud-Preparation-Tool"
(New-Object System.Net.WebClient).DownloadFile($ScriptWebArchive, "$LocalArchivePath.zip")
Expand-Archive "$LocalArchivePath.zip" -DestinationPath $LocalArchivePath -Force
CD $LocalArchivePath\Parsec-Cloud-Preparation-Tool-master\PostInstall
powershell.exe .\PostInstall.ps1 -DontPromptPasswordUpdateGPU