Tutorials - Learning-Oriented Guides¶
Welcome to the tutorials section! These step-by-step guides will help you learn the Qubinode KVM Host Setup Collection by doing. Each tutorial is designed to be completed in sequence, building your knowledge progressively.
Note
New to the collection? Start with the Quick Start Guide guide for a rapid introduction, or Your First KVM Host Setup for a comprehensive learning experience.
Getting Started¶
10-minute setup for experienced users
Get a KVM host running immediately with minimal configuration. Perfect if you’re already familiar with KVM and Ansible.
Comprehensive beginner guide
Complete walkthrough from installation to running VMs. Perfect for newcomers to KVM or the collection.
Core Tutorials¶
Set up networking for VMs
Learn to configure network bridges, NAT networks, and isolated networks for different VM scenarios.
Manage storage for VMs
Create and manage storage pools, understand different storage types, and optimize for performance.
Learning Path¶
Follow this recommended learning path:
Start Here: Quick Start Guide (experienced) or Your First KVM Host Setup (beginners)
Networking: Basic Network Configuration
Storage: Storage Pool Creation
Next Steps: Explore How-To Guides - Problem-Oriented Solutions for specific problems
Tutorial Characteristics¶
All tutorials in this section:
Are learning-oriented: Designed to help you learn by doing
Are safe to follow: Won’t break existing setups when followed correctly
Build progressively: Each tutorial builds on previous knowledge
Have clear outcomes: You’ll know exactly what you’ve accomplished
Include verification: Steps to confirm everything is working
What You’ll Learn¶
By completing these tutorials, you’ll understand:
KVM Host Setup: Complete automation of KVM host configuration
Network Management: Bridge creation, network isolation, connectivity testing
Storage Management: Storage pools, LVM configuration, performance optimization
Web Interface: Cockpit setup and management
Best Practices: Security, performance, and operational considerations
Prerequisites¶
Before starting the tutorials:
System: RHEL 8/9/10, Rocky Linux, or AlmaLinux
Hardware: CPU with virtualization support, 8GB+ RAM
Access: Administrative (sudo/root) access
Network: Internet connection for package downloads
Ansible: Version 2.13 or newer
Getting Help¶
If you encounter issues during tutorials:
Check troubleshooting sections in each tutorial
Review common issues in How to Troubleshoot Network Issues
Search documentation using the search box (Ctrl+K)
Ask for help in GitHub Discussions
Next Steps¶
After completing tutorials:
Solve specific problems: How-To Guides - Problem-Oriented Solutions
Contribute to the project: Developer How-To Guides - Contribution-Oriented
Look up technical details: Reference Documentation - Technical Specifications
Understand the architecture: Explanations - Understanding-Oriented Documentation