Create a virtual Linux workstation

This tutorial shows how to create a virtual Linux workstation running Ubuntu 22.04with avirtual display.A virtual display device is useful when applications on your virtual machine (VM)instances require a display device, but don't require the full power or cost ofaGPU.

For information about other types of virtual workstations, including Windows,seeAbout creating a virtual workstation.

Note: This solution is not suitable for graphically intensive applications thatrequire hardware graphics acceleration. For information about the typesof virtual workstations that you can create on Google Cloud, seeCreating a virtual workstation.

After you create the virtual workstation, you learn how to remotely access itusingHP Anyware(formerly Teradici CAS), usingPC-over-IP (PCoIP®)technology, a remote desktop protocol widely used in the media andentertainment, game development, architecture, and engineering industries. PCoIPoffers features essential to these types of workloads, such as color accuracy,support for multiple monitors, lossless display, and tablet pressure sensitivity.

This tutorial assumes you are familiar with the Linux command line.

Objectives

  • Create a Compute Engine VM. This VM serves as the foundation for a virtualworkstation.
  • Install HP Anyware software on the virtual workstation.
  • Connect to the virtual workstation using a PCoIP software client.
Note: This tutorial does not include advanced security features such asfine-grained SSH key management, certificate issuance, or multi-factorauthentication (MFA). A full deployment requires aconnection brokeranddomain controller,which help enable a stronger security profile for connecting to virtualworkstations.

Costs

This tutorial uses the following billable components ofGoogle Cloud:

You can use thepricing calculator to generate a cost estimate based on your projected usage.

The resources that make up the virtual workstation and the factors that affectcost in this tutorial are:

Internet data transfer represents data that streams from your virtual workstation toyour local display client and is billed atinternet outbound data transfer costs.Variables that affect data transfer during a PCoIP session are bandwidth, screenresolution, number of display monitors, applications used, and the type ofactivity on each monitor. The HP AnywareSession Planning Guidecan help you understand different workload requirements.

Note: Costs differ depending on region and connection method. Theseestimated costs are based on connection over the public internet, with resourceslocated in theus-central1 region (Iowa).

Before you begin

This tutorial uses the Google Cloud CLI, which you can run from aCloud Shell instance launched from theGoogle Cloud console.If you want to use gcloud CLI on your local workstation, install theGoogle Cloud CLI.The tutorial shows you how to run commands in Cloud Shell; if youuse the gcloud CLI on your workstation, adjust the instructionsaccordingly.

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.create permission.Learn how to grant roles.
    Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Compute Engine API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enable permission.Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.create permission.Learn how to grant roles.
    Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Compute Engine API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enable permission.Learn how to grant roles.

    Enable the API

In addition, make sure you have the following:

  • AGoogle Chromebrowser to access the Google Cloud console.
  • The latestPCoIP Client softwarefor Windows, Mac, or Linux to access the virtual workstation.
  • An account onhelp.teradici.comto download the HP Anyware software. Account registration is free.
  • An HP Anyware software license. You canrequest a trial license,or contact your HP representative and ask for a trial registrationcode to use for this virtual workstation.

Architecture

The following diagram shows the components that are used in this tutorial todeploy a single virtual workstation. Optional components shown in the diagraminclude different ways to connect to your virtual workstation, shared storage,an additional VM for serving third-party licenses, and additionalinfrastructure representing a render or compute farm.

Architecture of the virtual workstation infrastructure.

Choose a region

An important factor when you deploy a virtual workstation is the latency betweenyour location and the VM you create. The lower the latency, the better theexperience. Therefore, you want to place your VM in a region and zonethat's geographically closest to you.

Create the virtual workstation

In Cloud Shell, create the Compute Engine virtual workstation instance:

gcloud compute instances createVM_NAME \    --zone=ZONE \    --machine-type=e2-standard-4 \    --enable-display-device \    --image-project=ubuntu-os-cloud \    --image-family=ubuntu-2204-lts \    --boot-disk-size=20 \    --boot-disk-type=pd-balanced \    --network=default

Replace the following:

  • VM_NAME: a name for your VM instance.
  • ZONE: the zone that's geographically closestto you. An important factor when you deploy a virtual workstation isthe latency between your location and the VM you create. The lower thelatency, the better the experience. For information about the geographicallocation of zones, seeAvailable regions and zones.

After the virtual workstation is created, the VM status is displayed. Theoutput looks similar to the following:

NAME: test-workstationZONE: us-west1-bMACHINE_TYPE: e2-standard-4PREEMPTIBLE:INTERNAL_IP: 10.138.XX.XXXEXTERNAL_IP: XX.XXX.XXX.XXXSTATUS: RUNNING

Note the external IP address, you need it later in the tutorial.

Sign in to your virtual workstation

After you create the virtual workstation, you sign in to the machine so that youcan configure it.

  1. Connect to the virtual workstation using the following command:

    gcloud compute sshVM_NAME

  2. Set your account password. Logging into a virtual workstation using the PCoIPsoftware client requires a user password.

    sudo passwd `whoami`

    When you're prompted, enter a password. You will use this password laterin the tutorial to log on to your virtual workstation with the HP AnywarePCoIP Client.

Install the desktop environment

The default Google Cloud Ubuntu 22.04 image is a minimal installation ofUbuntu. Install a desktop environment to run your virtual workstation as a graphicalworkstation. For this tutorial, you install the KDE Plasma Desktop.

  1. Update the software repositories by running the following command:

    sudo apt update

  2. Install the desktop environment:

    sudo apt -y install kubuntu-desktop

  3. Reboot the workstation:

    sudo reboot

Your connection to the virtual workstation closes.

Install HP Anyware software

HP Anyware software provides an agent that runs on your virtual workstation,delivering the desktop to your hardware or software client.

Note: Installation may differ if you choose a different Linux distribution.For more information, seeHP Anyware Standard Agent for Linux Installation Guide.

  1. When the virtual workstation has restarted, in Cloud Shell,reconnect to the virtual workstation:

    gcloud compute sshVM_NAME

  2. Add the Teradici software repository:

    curl -1sLf \  https://dl.anyware.hp.com/TOKEN/pcoip-agent/cfg/setup/bash.deb.sh \  | sudo -E distro=ubuntu codename=jammy bash

    Replace the following:

  3. Update the software repositories:

    sudo apt update

  4. Optional: Install USB dependencies, if you need to support USB devices otherthan keyboards, mice, and pointer devices.

    Note: If you skip this step, USB redirection is disabled. That means youcan't use bridged USB devices.
    sudo apt -y install usb-vhci-dkms

  5. Install the HP Anyware software:

    sudo apt -y install pcoip-agent-standard

Register the Anyware Standard Agent

To use the Anyware Standard Agent, you must have an HP Anyware license.

  1. In Cloud Shell, activate your HP Anyware software license:

    pcoip-register-host --registration-code=REGISTRATION-CODE

    ReplaceREGISTRATION-CODE withthe code provided to youby HP Teradici in the formABCDEFGHIJKL@0123-4567-89AB-CDEF.

  2. Reboot the virtual workstation:

    sudo reboot

Create a firewall rule

The PCoIP client communicates with your virtual workstation using several ports.You must set firewall rules that allow traffic to your virtualworkstation.

Sign in to your virtual workstation using the PCoIP client

  1. On your local computer, go to thePCoIP Clients sectionon theHP Anyware support page,and then download, install, and launchthe PCoIP Software Client application for your operating system.

  2. In theHost Address or Registration Code field, enter the externalIP address of your virtual workstation. If you want, you can enter a name forthe connection.

    Note: By default, PCoIP traffic is encrypted using AES-256.However, HP Anyware Software uses a self-signed certificatethat's issued by Teradici. This might trigger a verification warning when youconnect. You can remove this warning by creating and installing your owncustom security certificates.Or, you can suppress the warning by changing theclient security modefor your client OS. For the purposes of this tutorial, you can ignore this warning by clickingConnect Insecurely in the dialog.

  3. When you are connected, authenticate by entering the username andpassword that you created earlier for the virtual workstation.

    In a few seconds, your Linux desktop appears.

Test your virtual workstation

After you've deployed your virtual workstation, you can test performance andinteractivity using a number of tools:

You can also learn more aboutPCoIP performance optimizationbased on your workload.

Clean up

To avoid incurring charges to your Google Cloud account for the resources used in this tutorial, either delete the project that contains the resources, or keep the project and delete the individual resources.

Stop your virtual workstation

Stopped virtual workstations incurcosts for persistent disk usage, but they can be restarted at any time. To stop your virtual workstation,run the following command:

gcloud compute instances stopVM_NAME

Delete all the components

  1. Delete the virtual workstation.
  2. Delete the firewall rule.

Delete the project

    Caution: Deleting a project has the following effects:
    • Everything in the project is deleted. If you used an existing project for the tasks in this document, when you delete it, you also delete any other work you've done in the project.
    • Custom project IDs are lost. When you created this project, you might have created a custom project ID that you want to use in the future. To preserve the URLs that use the project ID, such as anappspot.com URL, delete selected resources inside the project instead of deleting the whole project.
  1. In the Google Cloud console, go to theManage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then clickDelete.
  3. In the dialog, type the project ID, and then clickShut down to delete the project.

What's next

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.