For the complete documentation index, see llms.txt. This page is also available as Markdown.

New System Configuration

Post-installation checklist for preparing a new VergeOS system for production, covering cluster settings, licensing, SMTP, certificates, alerting, snapshots, and authentication configuration.

This page will guide you through preparing your installed VergeOS system for production; including configuration steps to ensure optimum performance, security, and reliability. For instructions on planning and completing an installation, refer to the VergeOS Implementation Guide.

System and Network Verification

Before proceeding:

  • Verify system status (all green status indicators)

  • Ensure correct networking configuration

Refer to Implementation Guide - Post-Installation for instructions on verifying system status and networking.

New System Task List

Cluster Settings

For each cluster, it's advisable to review and fine-tune settings during initial configuration because:

  • Most cluster changes require node reboots

  • Some cluster settings will be important to establish before putting your system into production

The Cluster Settings Guide provides detailed information regarding available settings.

Licensing/Updates

  1. Verify Your VergeOS Licensing: This will ensure your system will be able to run VMs, start NAS services, and run updates.

  2. Update your System: Perform an update if your system is not running the most up-to-date version. Running the newest version of VergeOS will guarantee you have all the latest features and improvements.

SMTP

Proper SMTP configuration is necessary for receiving email-based reports and alerts. See the SMTP Product Guide for instructions.

Server Certificate

By default, your VergeOS system is installed with a self-signed certificate. For public-facing and production systems it is important to install a trusted, CA-issued certificate to provide security and ensure trust between your system, browsers, and external platforms (for integrations). See Server Certificates for related instructions.

Alerting and Reporting

Configuring Subscriptions allows you to receive alerts and reports for effective system monitoring. Alerts (on-demand subscriptions) are essential for immediate notification when specific events occur (e.g. high storage usage percentage, drive warnings, system log errors, etc.), allowing for rapid response. Reports (scheduled subscriptions) enable you to receive summarized information on a specified schedule.

System Snapshot Settings

Full System Snapshots provide a point-in-time backup of your entire system. By default, your VergeOS system is configured to perform regular full system snapshots. You can customize this schedule to align with your organizational needs. See System Snapshots for instructions on adjusting the default frequency and retention of system snapshots.

Authentication/Authorization Settings

  1. Third-party Authorization Sources: Configure an Authorization Source for any external identity service (such as Google SSO or Microsoft Entra ID) you wish to utilize for VergeOS logins.

  2. Multifactor Authentication (MFA): MFA adds a critical security layer to your user accounts, ensuring that even if a password is compromised, unauthorized access is nearly impossible. With cyber threats on the rise, enabling MFA helps protect your systems and data. It is strongly advised that you require multifactor authentication for all user logins. Configure Multifactor Authentication for direct VergeOS logins.

When using external authorization sources (Google, Entra, etc.) for VergeOS, multifactor authentication should also be configured within those systems to ensure secure logins; consult the provider's related documentation for instructions.

. Password Complexity: The default password complexity requirement is a minimum length of 8 characters. Additional requirements (e.g.lowercase letters, uppercase letters, numbers, symbols) can also be added in Advanced Settings - Password Complexity Requirement

Last updated

Was this helpful?