Qubinode Navigator

Modern AI-enhanced, container-first infrastructure automation platform with modular plugin architecture, supporting RHEL 10, CentOS Stream 10, and next-generation enterprise deployments.

Get started now View on GitHub

Overview

Qubinode Navigator is a next-generation infrastructure automation platform built with a modular plugin architecture and AI-enhanced capabilities. It simplifies enterprise infrastructure deployment across multiple operating systems and cloud providers, with special focus on RHEL 10/CentOS Stream 10 support and container-first execution.

🚀 Key Features

  • 🔌 Plugin Architecture: Extensible framework with OS, cloud provider, and deployment plugins
  • 🤖 AI-Powered Assistant: PydanticAI orchestrator with RAG-powered documentation search and intent-based deployment
  • 🖥️ Next-Gen OS Support: Native RHEL 10, CentOS Stream 10, Rocky Linux, and Fedora support
  • 📦 Container-First: Ansible Navigator execution with standardized environments
  • 🌐 Multi-Cloud Ready: Equinix, Hetzner, AWS, and bare-metal deployments
  • 🔒 Enterprise Security: HashiCorp Vault integration and progressive SSH security
  • 📊 Workflow Orchestration: Apache Airflow DAGs for automated VM provisioning, service deployment, and infrastructure health checks
  • 🧪 Comprehensive Testing: 84%+ test coverage with real deployment validation

Quick Start

Prerequisites

  • Operating System: RHEL 9/10, CentOS Stream 10, Rocky Linux 9+, or Fedora 39+ (RHEL 8: legacy/compatibility only)
  • Memory: Minimum 8GB RAM (16GB+ recommended for AI features)
  • Storage: 50GB+ available space (100GB+ recommended)
  • Container Runtime: Podman or Docker
  • Network: Internet connectivity for package downloads

Installation 

# Clone the repository
git clone https://github.com/Qubinode/qubinode_navigator.git
cd qubinode_navigator

# Configure environment (set domain, AI model keys, etc.)
cp .env.example .env
# Edit .env with your settings (QUBINODE_DOMAIN, model API keys, etc.)

# Run pre-flight checks
./scripts/preflight-check.sh --fix

# Deploy full stack (recommended for most users)
./deploy-qubinode-with-airflow.sh

# OR: Deploy development version
# sudo -E ./scripts/development/deploy-qubinode.sh

Deployment Options

Deployment Method Description
Automated with Airflow Use Apache Airflow for orchestrated, reproducible deployments - see Airflow Getting Started
Production Deployment Follow best practices for production environments - see Deploy to Production
MCP Integration Deploy with Model Context Protocol servers - see MCP Production Setup

🏗️ Architecture & Design

Qubinode Navigator follows a modern, plugin-based architecture with comprehensive decision documentation:

📋 Latest Architectural Decisions (2025)

🏛️ Foundation ADRs

🔐 Enterprise Security

  • HashiCorp Vault Integration: Centralized secret management
  • Ansible Vault: Encrypted configuration files and credentials
  • Progressive SSH Security: Multi-layered access controls and key management
  • Container Isolation: Secure execution environments with Ansible Navigator
  • Credential Scanning: Automated detection of exposed secrets

🔌 Plugin Architecture

  • OS Plugins: RHEL 9/10, CentOS Stream 10, Rocky Linux 9+, Fedora (RHEL 8: legacy only)
  • Cloud Plugins: Equinix, Hetzner, AWS integrations
  • Environment Plugins: Red Hat Demo, development, production configurations
  • Service Plugins: Vault integration, monitoring, logging
  • Extensible Framework: Easy plugin development with standardized interfaces

Documentation Sections

This site follows the Diataxis framework for clear, well-organized documentation:

Section Description
Tutorials Learning-oriented guides that take you through a process step by step
How-To Guides Task-oriented recipes for accomplishing specific goals
Reference Information-oriented technical descriptions and API documentation
Explanation Understanding-oriented discussions that clarify concepts
ADRs Architecture Decision Records documenting key design choices

Community & Support

🤝 Contributing

We welcome contributions from the community! Here’s how you can get involved:

  • 📝 Documentation: Help improve our guides and documentation
  • 🐛 Bug Reports: Report issues and help us improve
  • 💡 Feature Requests: Suggest new features and enhancements
  • 🔧 Code Contributions: Submit pull requests with improvements

Read our Contributing Guide to get started.

📞 Support

License

This project is licensed under the GNU General Public License v3.0.

Qubinode Navigator - Simplifying OpenShift deployment on KVM infrastructure.