> 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/run-the-platform/platform-overview/new-system-configuration.md). # New System 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](/plan-and-deploy/implementation-guide/intro.md). ## System and Network Verification {% hint style="info" %} **Before proceeding:** * **Verify system status** (all green status indicators) * **Ensure correct networking configuration** Refer to [**Implementation Guide - Post-Installation**](/plan-and-deploy/implementation-guide/post-installation.md) for instructions on verifying system status and networking. {% endhint %} ## New System Task List * [ ] [Review/Adjust Cluster Settings](#cluster-settings) * [ ] [Confirm Licensing/Updates](#licensingupdates) * [ ] [Configure SMTP](#smtp) * [ ] [Register a Server Certificate](#server-certificate) * [ ] [Establish Alerting/Reporting](#alerting-and-reporting) * [ ] [Verify System Snapshot Settings](#system-snapshot-settings) * [ ] [Configure Authorization/Authentication Settings](#authenticationauthorization-settings) * [ ] [Optional - Enable Third-party Logging](/knowledge-base/troubleshooting/configuring-remote-log-forwarding.md) ## 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**](/run-the-platform/system-administration/cluster-settings.md) provides detailed information regarding available settings. {% hint style="success" %} **Learn about VergeOS Cluster Basics here:** [**Clusters Overview Guide**](/run-the-platform/system-administration/clusters-overview.md) {% endhint %} ## Licensing/Updates 1. [**Verify Your VergeOS Licensing**](/run-the-platform/system-administration/license-updates-verify.md): This will ensure your system will be able to run VMs, start NAS services, and run updates. 2. [**Update your System**](/knowledge-base/system-administration/updating-vergeos-system.md): 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. {% hint style="success" %} [**VergeOS Release Notes**](https://docs.vergeos-demo.com/release-notes/) **provides information about the current latest version.** {% endhint %} ## SMTP Proper SMTP configuration is necessary for receiving email-based reports and alerts. See the [**SMTP Product Guide** ](/run-the-platform/system-administration/smtp.md)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**](/run-the-platform/system-administration/certificates.md) for related instructions. {% hint style="success" %} **A CA-issued certificate may be less important for home labs, or other non-critical systems that are used solely within a private infrastructure.** {% endhint %} ## Alerting and Reporting Configuring [**Subscriptions**](/run-the-platform/system-administration/subscriptions-overview.md) 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**](/automate-protect-and-extend/backup-and-dr/system-snapshots.md) for instructions on adjusting the default frequency and retention of system snapshots. {% hint style="success" %} **After creating tenants, VMs and NAS volumes, you can also create individualized snapshot frequency and retention for these items where needed.** {% endhint %} ## Authentication/Authorization Settings 1. **Third-party Authorization Sources:** [**Configure an Authorization Source**](/run-the-platform/authentication/auth-sources-overview.md) 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**](/run-the-platform/authentication/multifactor-auth.md). {% hint style="info" %} **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**](/run-the-platform/system-administration/advanced-system-settings.md) - ***Password Complexity Requirement*** {% endhint %} {% hint style="warning" %} **User Security** Strong user security practices are essential for protecting systems and data from unauthorized access and potential breaches. By assigning unique accounts to each user, limiting permissions to only what's necessary, and regularly reviewing audit logs, organizations can reduce risks and ensure accountability across their environments. {% endhint %} --- # 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/run-the-platform/platform-overview/new-system-configuration.md?ask= ``` 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.