VergeOS Post-Installation Guide#

Overview#

After installing VergeOS, there are several important configurations and tweaks you should consider. This guide will walk you through the essential post-installation steps to optimize your VergeOS environment.

Steps#

Log into the VergeOS UI
Navigate to System Settings - Go to System > Cluster
Review and Adjust Cluster Settings - Check the maximum RAM allocation for VMs - Verify the maximum number of cores allowed - Review swap settings
Configure Performance Settings - For high-performance environments, consider disabling CPU sleep states - For edge deployments or power-saving scenarios, you may want to use balanced performance settings
Adjust Advanced Settings - Go to System > Settings > Advanced Settings - Review and modify as needed:
- Default tiers for drives
- Default MTU
- Default network schemes for internal networks
- Default media file tier (e.g., change to Tier 3 for ISOs)
Configure Storage Tiers - Ensure proper configuration of storage tiers based on your hardware - Remember that tiers should ideally range from Tier 1 (highest performance) to Tier 5 (lowest performance) - Note: The system will use the closest available tier if a specified tier is not available
Review Security Settings - For dedicated controller nodes, consider disabling CPU security mitigations for performance - Only disable if you trust all workloads in the environment
Update Location Settings - Go to System > Settings - Update the location information if necessary

Important Considerations#

Changes to swap settings require disk reformatting and are not applied in real-time
When adding new nodes, ensure storage capacity matches across all nodes in a tier to maintain redundancy
The Target Max RAM Percent setting affects the amount of RAM available for VMs

Troubleshooting#

If you encounter issues or have questions about these post-installation steps, please contact our support team for assistance.

Document Information

Last Updated: 2024-10-15
VergeOS Version: 4.12.6