Skip to main content

Overview

Configuration is the main settings interface for your entire cloud. All settings are saved to globals.yml --- the master deployment configuration file that controls every aspect of your environment. Instead of editing YAML manually, XDeploy provides forms, dropdowns, toggles, and validation across eight configuration tabs.
Prerequisites
  • Bootstrap completed on the deployment server
  • Hosts configured with verified SSH access
  • Network interface names identified on all target servers
  • Virtual IP (VIP) addresses planned for your management subnet

Configuration Tabs

Log in to XDeploy (https://xdeploy.<your-domain>) on the deployment node using administrative access. Navigate to Configuration in the left sidebar. The configuration interface is organized into eight tabs, each handling a distinct area of your deployment settings.
The primary settings tab covering networking, domains, and TLS configuration. These settings form the foundation of your entire deployment.

Network Configuration

FieldRequiredDescription
API/Management Network InterfaceYesSelect the NIC used for management traffic. Auto-fills the Internal VIP field based on the selected interface subnet.
Internal VIP AddressYesVirtual IP for internal API calls. Floats between controllers via HAProxy for high availability.
External VIP AddressNoPublic-facing VIP for external access and the Xloud Dashboard. Required only if external access is needed.
The Internal VIP is the single most important setting in your deployment. If it is wrong, nothing works. Ensure it is an unused IP address on the management subnet that does not conflict with any existing host.

Domain Configuration

FieldDescription
Enable Domain SetupToggle to configure FQDNs instead of raw IP addresses for service endpoints
Internal FQDNHostname for internal API endpoints (e.g., xavs-int.example.com). Must resolve to the Internal VIP.
External FQDNHostname for external access (e.g., xavs.example.com). Must resolve to the External VIP.

TLS/SSL Configuration

Visible when Domain Setup is enabled. Configure certificate-based encryption for API endpoints.
FieldDescription
Internal API TLSToggle to enable TLS for internal service communication. Upload the certificate and private key.
External API TLSToggle to enable TLS for the public-facing Dashboard and API. Upload the certificate and private key.
Certificates are saved to /etc/xavs/certificates/ on the deployment node and distributed to all controllers during deployment.
For production deployments, always enable TLS on external endpoints. Internal TLS is recommended when the management network is shared or untrusted.

Next Steps

Container Images

Pull or extract container images required for deploying cloud services

Operations

Deploy, upgrade, reconfigure, and manage cloud services across your cluster