Welcome to the new VergeOS docs! The legacy docs remain available until they're retired later this year.
Legacy VergeOS Docs
Ctrlk
Verge.ioGitHub repoSupport
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Learn the platform

Hands-on training for architecting, deploying, and operating VergeOS infrastructure.

This is a hands-on lab workbook for anyone architecting, deploying, and operating VergeOS infrastructure. The program follows a linear progression from foundational concepts through advanced scenario-based labs.

New to VergeOS? Start with Module 1: Architecture Fundamentals and work through the modules in order — each one builds on the concepts before it.

Who this is for

  • IT Administrators deploying, configuring, and maintaining VergeOS clusters

  • Solutions Architects scoping and designing VergeOS environments

  • Operations Staff monitoring and troubleshooting day-to-day infrastructure

  • DevOps Engineers automating VergeOS with APIs, Terraform, and scripting tools

  • Channel Partners building expertise to support customer deployments

Prerequisites

  • Hands-on experience with server and network infrastructure

  • Familiarity with virtualization concepts (hypervisors, virtual machines, virtual networking)

  • VMware or Nutanix experience is helpful but not required — VMware Bridge and Nutanix Bridge callouts throughout the modules map VergeOS concepts to their equivalents for anyone coming from either platform

  • Access to bare-metal hardware for lab exercises (or a VergeOS lab environment)

Modules

The curriculum is organized into 10 modules that progress from architecture fundamentals through real-world deployment scenarios.

1. Architecture Fundamentals

HCI vs UCI, VergeFS storage, core fabric networking, clusters and node types.

2. Sizing & Design

Hardware requirements, reference architectures, and customer scoping exercises.

3. Installation

Bare-metal install, BIOS/disk prep, network prerequisites, and post-install checklist.

4. Networking

VergeFabric, VLANs, firewall rules, routing (BGP/OSPF), and network design.

5. Storage

vSAN tiers, storage provisioning, NAS configuration, and best practices.

6. Virtual Machines

VM creation, recipes, templates, GPU passthrough, and migration workflows.

7. Multi-Tenancy

Tenant creation, resource allocation, isolation boundaries, and tenant recipes.

8. Developer / DevOps

API, Terraform provider, pyvergeos, PowerShell, automation, and cloud-init.

9. Monitoring & Troubleshooting

Dashboard, logs, alerts, common issues, and support escalation.

10. Scenario Labs

Deploy HCI/UCI/hybrid topologies and perform VMware migrations using the Terraform playground.

How to use this training

Each module includes:

  • Concept pages with diagrams, explanations, and VMware/Nutanix Bridge callouts for readers coming from either platform

  • Hands-on lab exercises with step-by-step instructions (early modules) progressing to guided challenges (later modules)

  • Architecture diagrams rendered as Mermaid visualizations you can reference during labs

Lab environment

Labs use a combination of:

  • Your own VergeOS environment on bare-metal hardware for installation and configuration exercises

  • The Terraform Playground for exploring deployment topologies and automation scenarios

Specific environment requirements are listed at the beginning of each lab exercise.

Related spaces

NextOverview

Last updated

Was this helpful?