> For the complete documentation index, see [llms.txt](https://docs.vergeos-demo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vergeos-demo.com/learn-the-platform/readme.md).

# Learn the platform

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.

{% hint style="info" %}
New to VergeOS? Start with **Module 1: Architecture Fundamentals** and work through the modules in order — each one builds on the concepts before it.
{% endhint %}

## 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.

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3><i class="fa-sitemap">:sitemap:</i></h3></td><td><strong>1. Architecture Fundamentals</strong></td><td>HCI vs UCI, VergeFS storage, core fabric networking, clusters and node types.</td><td><a href="/pages/sSLSYA6Fh5JBt2z0GI8G">/pages/sSLSYA6Fh5JBt2z0GI8G</a></td></tr><tr><td><h3><i class="fa-ruler-combined">:ruler-combined:</i></h3></td><td><strong>2. Sizing &#x26; Design</strong></td><td>Hardware requirements, reference architectures, and customer scoping exercises.</td><td><a href="/pages/Ufp2MKazOHEqM0etzo57">/pages/Ufp2MKazOHEqM0etzo57</a></td></tr><tr><td><h3><i class="fa-screwdriver-wrench">:screwdriver-wrench:</i></h3></td><td><strong>3. Installation</strong></td><td>Bare-metal install, BIOS/disk prep, network prerequisites, and post-install checklist.</td><td><a href="/pages/qz3tymK7yuZOCOkuXoHY">/pages/qz3tymK7yuZOCOkuXoHY</a></td></tr><tr><td><h3><i class="fa-network-wired">:network-wired:</i></h3></td><td><strong>4. Networking</strong></td><td>VergeFabric, VLANs, firewall rules, routing (BGP/OSPF), and network design.</td><td><a href="/pages/fDHLjQBPzAvyiK74wg6M">/pages/fDHLjQBPzAvyiK74wg6M</a></td></tr><tr><td><h3><i class="fa-database">:database:</i></h3></td><td><strong>5. Storage</strong></td><td>vSAN tiers, storage provisioning, NAS configuration, and best practices.</td><td><a href="/pages/9tGS26R36Ders1Fp6HXc">/pages/9tGS26R36Ders1Fp6HXc</a></td></tr><tr><td><h3><i class="fa-desktop">:desktop:</i></h3></td><td><strong>6. Virtual Machines</strong></td><td>VM creation, recipes, templates, GPU passthrough, and migration workflows.</td><td><a href="/pages/uKHGQKM51YscBTrRlxDJ">/pages/uKHGQKM51YscBTrRlxDJ</a></td></tr><tr><td><h3><i class="fa-users">:users:</i></h3></td><td><strong>7. Multi-Tenancy</strong></td><td>Tenant creation, resource allocation, isolation boundaries, and tenant recipes.</td><td><a href="/pages/nsQQM9DGIU9U0JDVbFNL">/pages/nsQQM9DGIU9U0JDVbFNL</a></td></tr><tr><td><h3><i class="fa-code">:code:</i></h3></td><td><strong>8. Developer / DevOps</strong></td><td>API, Terraform provider, pyvergeos, PowerShell, automation, and cloud-init.</td><td><a href="/pages/ySTKwfyLNkCkkhlaj8VR">/pages/ySTKwfyLNkCkkhlaj8VR</a></td></tr><tr><td><h3><i class="fa-gauge-high">:gauge-high:</i></h3></td><td><strong>9. Monitoring &#x26; Troubleshooting</strong></td><td>Dashboard, logs, alerts, common issues, and support escalation.</td><td><a href="/pages/SUKZk6QF7Dnch0Agt4TP">/pages/SUKZk6QF7Dnch0Agt4TP</a></td></tr><tr><td><h3><i class="fa-flask">:flask:</i></h3></td><td><strong>10. Scenario Labs</strong></td><td>Deploy HCI/UCI/hybrid topologies and perform VMware migrations using the Terraform playground.</td><td><a href="/pages/T6t52LMZijqQmgQgjuBE">/pages/T6t52LMZijqQmgQgjuBE</a></td></tr></tbody></table>

## 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**](https://github.com/verge-io/vergeos-terraform-playground) for exploring deployment topologies and automation scenarios

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

## Related spaces

* Deployment planning: [Plan and deploy](https://docs.vergeos-demo.com/plan-and-deploy/)
* Day-2 operations: [Run the platform](https://docs.vergeos-demo.com/run-the-platform/)
* Disaster recovery and automation: [Automate, protect, and extend](https://docs.vergeos-demo.com/automate-protect-and-extend/)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vergeos-demo.com/learn-the-platform/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
