> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/system-administration.md). # System administration - [Advanced System Settings](https://docs.verge.io/run-the-platform/system-administration/advanced-system-settings.md): Reference for all advanced system settings in VergeOS, including NTP, SMART thresholds, session timeouts, MAC prefix, migration controls, two-factor authentication, and vSAN configuration. - [API Keys](https://docs.verge.io/run-the-platform/system-administration/api-keys.md): How to create, manage, and use API keys for programmatic access to the VergeOS REST API, including authentication, IP access controls, expiration settings, and security best practices. - [Server Certificates](https://docs.verge.io/run-the-platform/system-administration/certificates.md): How to manage TLS/SSL certificates in VergeOS, including requesting Let's Encrypt certificates, installing manual certificates, configuring listeners, and registering custom root CAs. - [Cluster Settings](https://docs.verge.io/run-the-platform/system-administration/cluster-settings.md): Reference for all VergeOS cluster configuration settings, including CPU type, RAM allocation, security mitigations, compute resource policies, swap, and node temperature monitoring. - [VergeOS Clusters Overview](https://docs.verge.io/run-the-platform/system-administration/clusters-overview.md): Overview of VergeOS clusters, including cluster types (HCI, compute-only, storage-only), cluster requirements, scalability design, and best practices for workload organization. - [Core Fabric Status Guide](https://docs.verge.io/run-the-platform/system-administration/core-fabric-status.md): How to read, interpret, and troubleshoot core fabric status in VergeOS, including score values, healthy vs. unhealthy fabric examples, and pre-maintenance verification. - [Device Passthrough Overview](https://docs.verge.io/run-the-platform/system-administration/device-pass-overview.md): Overview of device passthrough in VergeOS, including PCI passthrough risks, IOMMU grouping, resource groups, resource rules, and supported passthrough types (PCI, USB, vGPU, SR-IOV). - [System Diagnostics](https://docs.verge.io/run-the-platform/system-administration/diagnostics.md): How to generate, download, and send VergeOS system diagnostics files for troubleshooting, including file contents, layout, and usage guidance. - [Drive Replacement](https://docs.verge.io/run-the-platform/system-administration/drive-replacement.md): Redirect page pointing to the centralized drive replacement standard operating procedure in VergeOS. - [One-to-One PCI Passthrough](https://docs.verge.io/run-the-platform/system-administration/generic-pci-passthrough.md): How to configure one-to-one PCI passthrough in VergeOS, including host setup, VM guest configuration, resource group creation, and passing PCI devices to tenants. - [IPMI](https://docs.verge.io/run-the-platform/system-administration/ipmi.md): How to configure and use IPMI integration in VergeOS for remote server power control, connectivity testing, credential management, and accessing the IPMI web interface. - [Verify Licensing and Update Server Configuration](https://docs.verge.io/run-the-platform/system-administration/license-updates-verify.md): How to verify connectivity to the VergeOS update server and troubleshoot licensing configuration issues, including credentials and update source selection. - [Licensing and Software Updates](https://docs.verge.io/run-the-platform/system-administration/licensing-and-updates.md): How to manage VergeOS software updates and licensing, including the update process, update settings, automatic updates, snapshot settings, and air-gap licensing. - [Licensing Overview](https://docs.verge.io/run-the-platform/system-administration/licensing-overview.md): Overview of VergeOS licensing, including System IDs, license types (production and trial/NFR), license details, reinstallation reactivation, and air-gap licensing. - [Node Diagnostics Guide](https://docs.verge.io/run-the-platform/system-administration/node-diagnostics.md): Comprehensive reference for VergeOS node diagnostic tools, including IPMI commands, SMART tests, network diagnostics, fabric configuration, and hardware troubleshooting. - [Nodes Overview](https://docs.verge.io/run-the-platform/system-administration/nodes-overview.md): Overview of VergeOS node management, including node status, hardware configuration, resource metrics, drives, NICs, fabric status, running machines, and management operations. - [NVIDIA vGPU Configuration](https://docs.verge.io/run-the-platform/system-administration/nvidia-vgpu-configuration.md): Step-by-step guide to configuring NVIDIA vGPU in VergeOS, including traditional vGPU profiles, MIG partitioning, heterogeneous profiles, resource group setup, and tenant sharing. - [Permissions](https://docs.verge.io/run-the-platform/system-administration/permissions.md): How to configure and manage user and group permissions in VergeOS, including permission levels, scopes, effective permissions, and assigning permissions to specific objects. - [Licensing and Software Updates](https://docs.verge.io/run-the-platform/system-administration/running-updates.md): Step-by-step guide for running VergeOS software updates, including the download-install-reboot process, update settings, automatic updates, and air-gap licensing. - [The System Event Log (SEL)](https://docs.verge.io/run-the-platform/system-administration/sel.md): How to view and clear the IPMI System Event Log (SEL) on VergeOS nodes, including capacity monitoring and log management. - [Service Containers](https://docs.verge.io/run-the-platform/system-administration/service-containers.md): Overview of VergeOS service containers, lightweight environments used to run internal system services such as AI modules, providing modularity, isolation, and efficient resource usage. - [System Settings](https://docs.verge.io/run-the-platform/system-administration/settings-overview.md): Overview of VergeOS system settings, including general configuration, version information, license details, location settings, connection details, and how to modify settings. - [Configuring the Sites Dashboard (Adding Sites)](https://docs.verge.io/run-the-platform/system-administration/site-dashboard-add-sites.md): How to add remote VergeOS systems to the Sites Dashboard, including configuring sync, statistics monitoring, machine management, and repair server options. - [Sites Dashboard](https://docs.verge.io/run-the-platform/system-administration/sites-overview.md): Overview of the VergeOS Sites Dashboard for centralized monitoring and administration of multiple VergeOS systems, including site statistics, VM management, and sync access. - [SMTP](https://docs.verge.io/run-the-platform/system-administration/smtp.md): How to configure, test, and troubleshoot SMTP email settings in VergeOS, including relay configuration, TLS, queue management, mail logs, and troubleshooting delivery issues. - [SR-IOV NICs](https://docs.verge.io/run-the-platform/system-administration/sriov-nics.md): How to configure SR-IOV NIC passthrough in VergeOS, including creating resource groups, configuring virtual functions, VM guest setup, and sharing SR-IOV devices to tenants. - [Subscription Profiles](https://docs.verge.io/run-the-platform/system-administration/subscription-profiles.md): Overview of VergeOS subscription profiles, which define the information included in subscription notification emails for alerts and scheduled reports. - [Viewing and Accessing Subscriptions](https://docs.verge.io/run-the-platform/system-administration/subscriptions-accessing.md): How to view and access your own subscriptions and all system subscriptions in VergeOS, including navigation paths and permission considerations. - [Creating Subscriptions](https://docs.verge.io/run-the-platform/system-administration/subscriptions-overview.md): How to create on-demand alert and scheduled report subscriptions in VergeOS, including subscription types, configuration options, throttling, reminders, and practical examples. - [Tags](https://docs.verge.io/run-the-platform/system-administration/tags.md): How to create, manage, and assign tags and tag categories in VergeOS to organize and classify system objects such as VMs, tenants, and nodes. - [VergeOS Theme Functionality](https://docs.verge.io/run-the-platform/system-administration/themes.md): How to create and manage custom UI themes in VergeOS, including color customization for graphs, navigation, headers, loader elements, custom logos, favicons, and theme hierarchy. - [Licensing and Software Updates](https://docs.verge.io/run-the-platform/system-administration/update-settings.md): Reference for VergeOS update settings, including update source, authentication, automatic updates, warm reboot, multi-cluster updates, snapshot policies, and privacy settings. - [USB Passthrough](https://docs.verge.io/run-the-platform/system-administration/usb-passthrough.md): How to configure USB device passthrough in VergeOS, including host setup, resource group creation, VM guest configuration, and passing USB devices to tenants. - [Users and Groups](https://docs.verge.io/run-the-platform/system-administration/users-groups.md): How to create and manage users and groups in VergeOS, including user types, password policies, two-factor authentication, SSH keys, physical access, and group membership. --- # 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, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/system-administration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.