Skip to content

Getting Started

In this guide we will walk you through the following:

  • Installing KubeVirt and our Generic Ephemeral VM plugins
  • Create and configure a Windows VM workload Template
  • Launch and connect to a Windows VM workload template
  • Setup and install Windows along with Rustdesk
  • Create a golden image of our VM

If you are new to Orion, please see our getting started docs before following this guide.

Hardware Requirements

Minimum specifications for running Windows VMs:

Resource Minimum Recommended
CPU Cores 16 cores 20+ cores
RAM 32 GB 64 GB
Storage 200 GB free 500+ GB free

Important: These are cluster-level minimums. Individual Windows VMs require at least 4 cores and 8 GB RAM each. Plan your capacity accordingly.

Step 1: Install the KubeVirt Plugin

Start by installing the KubeVirt plugin from the Terra Official Plugins repo.

Important

Install this plugin FIRST. The Generic Ephemeral VM plugin depends on KubeVirt being installed.

1. Navigate to the Terra App Store

settings menu

2. Install KubeVirt

Search for the Kubevirt plugin in the Terra App Store.

settings menu

Once found, select the plugin, fill out the form and click Install

settings menu

Note

For clusters composed of Virtual Machines (meaning the cluster is deployed on top of VMs), nested virtualization must be enabled. Bare-metal deployments typically don't require this.

Step 2: Install the Generic Ephemeral VM Plugin

This plugin provides the schema/template for creating VM workloads.

Important

Install this plugin SECOND. It requires KubeVirt to be installed first.

1. Navigate to the Terra App Store

settings menu

2. Install Generic Ephemeral VM

Search for the Generic Ephemeral VM plugin in the Terra App Store.

settings menu

Once found, select the plugin, fill out the form and click Install

settings menu