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: CPU-based AI deployment guidance with interactive troubleshooting (coming soon)
  • 🖥️ 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
  • 📊 Automated Updates: Intelligent update detection and compatibility validation (coming soon)
  • 🧪 Comprehensive Testing: 84%+ test coverage with real deployment validation

Quick Start

Prerequisites

  • Operating System: RHEL 8/9/10, CentOS Stream 10, Rocky Linux, or Fedora
  • Memory: Minimum 4GB RAM (8GB+ recommended for AI features)
  • Storage: 500GB+ available space
  • Container Runtime: Podman or Docker
  • Network: Internet connectivity for package downloads
# Clone the repository
git clone https://github.com/Qubinode/qubinode_navigator.git
cd qubinode_navigator

# Run the modernized setup script with plugin framework
./setup_modernized.sh

Plugin Framework CLI 

# List available plugins
python3 qubinode_cli.py list

# Deploy with specific OS plugin
python3 qubinode_cli.py deploy --plugin rhel10

# Get plugin information
python3 qubinode_cli.py info --plugin centos_stream10

Legacy Installation 

# Traditional setup script (compatibility mode)
./setup.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 8/9/10, CentOS Stream 10, Rocky Linux, Fedora
  • 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.