Skip to main content
XDeploy is the deployment and management platform that transforms bare servers into a fully operational cloud infrastructure. It provides a guided wizard-style interface for every stage — from server preparation and hardware validation to production deployment and ongoing lifecycle management.
Prerequisites — Before starting any deployment workflow, ensure you have:
  • Physical or virtual servers running XOS (Ubuntu 24.04 LTS based)
  • Root or sudo access on all target nodes
  • Network connectivity between all cluster nodes
  • A valid XDeploy activation key from license.xloud.tech

​
Deployment Workflow

Follow this sequence for a successful deployment. Each stage builds on the previous one.

Activate XDeploy

Enter your activation key to unlock the platform. Without activation, all tools remain locked.

Bootstrap

Validate hardware, install dependencies (Python, Ansible, CLI clients).

Hosts

Build cluster inventory, establish SSH, assign node roles.

XSDS Bootstrap

Deploy the distributed storage cluster. Skip this step if not using XSDS as your storage backend.

Configuration

Set networking, storage, monitoring, and feature toggles.

Images

Pull or extract container images for all services.

Deploy

Run the deployment playbook (30-90 minutes).

License

Activate the deployed cluster with your license file.

Management

Create users, projects, quotas, and credentials.
For production deployments, always run Prechecks before Deploy in the Operations tool. Prechecks validate ports, services, and configurations before committing to a full deployment.

​
Pre-Deployment Checklist

Complete every step below before initiating your first deployment.

Install XOS on All Nodes

All target servers must be running XOS (Xloud OS based on Ubuntu 24.04 LTS). XOS includes all required kernel modules, drivers, and base packages pre-configured for cloud deployment.
XOS is available as an ISO from your Xloud representative or the license portal. See the XOS product page for details.

Verify Hardware Requirements

Confirm every target server meets or exceeds these minimums:
ResourceMinimumProduction
CPU Cores416+
RAM8 GB32-64 GB
Root Filesystem100 GB200+ GB
Network Interfaces24+ (bonded for redundancy)
Each cloud service container consumes 200-500 MB of RAM. A production control plane with all services enabled requires 32 GB minimum.

Plan Your Network

Separate traffic types onto dedicated VLANs and subnets for security and performance:
NetworkPurposeVLAN Required
API / ManagementAPI endpoints, SSH, Ansible, internal servicesYes
VM Traffic (Tenant)Instance-to-instance communicationYes
Provider / ExternalFloating IPs, VM internet accessYes
Load Balancer (Octavia)Amphora management trafficYes (if LBaaS enabled)
Storage Client (XSDS)Client-to-Ceph I/ORecommended
Storage Replication (XSDS)Ceph OSD-to-OSD replicationRecommended
Additional Provider VLANsCustomer-specific external networksAs needed
Never mix management and provider traffic on a single NIC. If tenant VM traffic saturates the interface, the control plane becomes unreachable.

Prepare DNS and SSL

For production deployments with HTTPS API endpoints:
  • Configure DNS records pointing to your Internal and External VIP addresses
  • Obtain TLS/SSL certificates for your domain (wildcard or per-service)
  • XDeploy supports both internal and external API TLS independently
Domain and SSL configuration is optional for lab/testing environments. You can use raw IP addresses without TLS for initial deployments.

Gather Credentials

Collect the following before starting:
  • SSH credentials from the deployment node to all target servers (password or key-based)
  • XDeploy activation key (.xlic) from license.xloud.tech
  • Cluster license key (.xlic) from license.xloud.tech

Choose Architecture and Node Roles

Select the deployment architecture that matches your requirements:

All-in-One (AIO)

Single server runs all roles. For labs, demos, and development. Minimum 1 node.

Hyper-Converged (HCI)

Each node runs compute + storage together. Reduces hardware count. Minimum 3 nodes for HA.

Distributed

Dedicated nodes per role — separate controller, compute, and storage. Maximum performance and isolation. Minimum 5+ nodes.
For production environments, Xloud recommends HCI with a minimum of 3 nodes or Distributed with 5+ nodes for full high availability.
Deploying on servers that do not meet minimum requirements leads to failures 30-45 minutes into deployment. Always run Bootstrap hardware checks first.

​
Platform Tools

XDeploy provides 11 specialized tools, each handling a distinct stage of the deployment and management lifecycle.

Bootstrap

Server readiness validation and dependency installation

Hosts

Cluster inventory management and SSH connectivity setup

Configuration

Cloud settings via guided forms — networking, storage, features

Advanced Config

Per-service configuration file editor with version tracking

Images

Container image management, registry, and extraction

Operations

Deploy, upgrade, reconfigure, and destroy cloud services

Management

Users, projects, quotas, and credential management

Cloud Fleet

Interactive infrastructure topology map

XSDS Storage

Distributed storage deployment and tier management

Cluster License

Cluster licensing and activation

XDeploy Key

XDeploy tool activation and license management

​
Next Steps

XDeploy Key

Start here — activate XDeploy before using any other tools

Bootstrap

Validate server hardware and install all required dependencies