Server readiness validation and dependency installation for cloud deployment
Bootstrap is the preflight checklist for your server. Before deploying cloud services, every target server must meet hardware requirements and have all software dependencies installed. Bootstrap automates detection, validation, and installation — ensuring a clean foundation for deployment.
Prerequisites
Physical or virtual server with root or sudo access
Internet connection (required for package installation)
Ubuntu 24.04 LTS (XOS) recommended as the base operating system
The Bootstrap module is organized into four tabs. Navigate between tabs to inspect specific subsystems or install dependencies.
Overview
Hardware
Dependencies
Logs
Quick snapshot of server health without modifying anything. Four information cards are displayed:
Operating System
Linux distribution, kernel version, package manager, and XDeploy mode (AIO or Multi-Node)
System Status
Uptime, CPU load average and usage percentage, memory used vs total
Storage Overview
Root filesystem type and free space, total disk count, storage type (SSD/HDD)
Network Overview
Interface count, internet connectivity, primary IP address, DNS resolution status
Quick Actions at the bottom: Run Hardware Checks and Install All Information.
Runs automated hardware requirement checks and shows detailed specifications. Each check shows a green checkmark (pass) or red indicator (fail).5 Requirement Checks:
Check
Minimum
Why
Root Filesystem
100 GB
Services, Docker images, and logs
Network Interfaces
2
Management NIC + provider/external NIC
Additional Disk or Volume Group
Optional
Required for persistent block storage volumes
CPU Cores
4 (16+ production)
Control plane needs ~2 cores, compute needs the rest
RAM
8 GB (32-64 GB production)
Each service container uses 200-500 MB
Servers below minimums are flagged but not blocked — you can proceed for development and testing.
Hardware Details (expandable sections):
CPU Information
Model name, physical cores, logical threads, architecture (x86_64/ARM), and hardware virtualization support (VT-x/AMD-V). Virtualization is required for running VMs.
Memory Information
Total installed, currently available, in use, and swap size.
Storage Information
Root filesystem type (ext4, xfs), all block devices (sda, nvme0n1, etc.), LVM volume groups, and mount points. Identifies disks available for block storage.
Network Information
Active interfaces, link types (ethernet, bond, bridge), all IP addresses, and default gateway.
The Dependencies tab validates and installs 7 software groups required for deployment. Each group addresses a specific layer of the deployment stack.
ALL 7 dependency groups must pass before proceeding to the next stage. If even one group fails, deployment will break — sometimes 45 minutes in, when a missing library causes a playbook task to fail.
Command-line tools for post-deployment management and troubleshooting
Configuration Setup
/etc/xdeploy directory with correct ownership and permissions
Scaffolds the configuration directory structure: globals, inventory, and password files
Password Generation
Auto-generated secure random passwords
Produces 50+ internal passwords for databases, service accounts, and message queue authentication
Use Install All to install every dependency group in sequence with a single action. Once a group passes validation, its individual Install button is disabled to prevent accidental re-installation.
Every Bootstrap action is recorded in a live scrolling terminal log with timestamps. Use this log to diagnose failures — it captures the full output of every package installation, validation check, and error message. The log persists across page refreshes, so you can return to it at any time during the session.
Python Dependencies group fails with compilation errors
Cause: Missing build tools or development headers on the base operating system.Resolution: Verify that build-essential, python3-dev, and libffi-dev are available in the system package repository. On XOS, these packages are pre-installed. On other Ubuntu 24.04 installations, run:
Retry the Python Dependencies installation after installing the missing packages.
Network Overview shows no internet connectivity
Cause: DNS resolution failure or firewall blocking outbound connections.Resolution: Verify that /etc/resolv.conf contains valid nameservers and that outbound HTTPS (port 443) is not blocked by a firewall or proxy. Bootstrap requires internet access to download packages from Ubuntu and Python package repositories.
Test DNS and connectivity
Copy
nslookup archive.ubuntu.comcurl -s https://pypi.org/simple/ | head -1
Dependency installation hangs or times out
Cause: Slow or unreliable network connection to package repositories.Resolution: Check network throughput between the server and the internet. If using a corporate proxy, ensure the proxy is configured in the system environment variables (http_proxy, https_proxy). Consider using a local package mirror for air-gapped or bandwidth-constrained environments.
