hyper2kvm

Hyper2KVM Tutorials

Step-by-step tutorials for learning Hyper2KVM, from beginner to enterprise deployment.

Learning Path

Follow these tutorials in order for the best learning experience:

🟢 Level 1: Beginner (0-2 hours)

01 - Beginner Migration

Your first VM migration with detailed explanations.

Prerequisites: None - start here!

What you’ll learn:

Time: 1-2 hours
Difficulty: ⭐ Easy

🟡 Level 2: Intermediate (2-8 hours)

02 - Intermediate Workflows

Batch migrations, automation, and advanced workflows.

Prerequisites: Complete beginner tutorial

What you’ll learn:

Time: 4-8 hours
Difficulty: ⭐⭐ Moderate

🟠 Level 3: Advanced (8+ hours)

03 - Advanced Features

Live migration, DR testing, and database-aware migrations.

Prerequisites: Complete intermediate tutorial

What you’ll learn:

Time: 8+ hours
Difficulty: ⭐⭐⭐ Advanced

🔴 Level 4: Enterprise (Full deployment)

04 - Enterprise Deployment

Production deployment strategies and best practices.

Prerequisites: Complete advanced tutorial

What you’ll learn:

Time: Full implementation project
Difficulty: ⭐⭐⭐⭐ Expert

Quick Reference

By Skill Level

Level Tutorial Time Prerequisites
Beginner 01 - Beginner 1-2h None
Intermediate 02 - Intermediate 4-8h Tutorial 01
Advanced 03 - Advanced 8+h Tutorial 02
Enterprise 04 - Enterprise Project Tutorial 03

By Topic

Topic Tutorial Level
First Migration Tutorial 01 Beginner
Batch Migration Tutorial 02 Intermediate
Live Migration Tutorial 03 Advanced
Windows VMs Tutorial 01, 02 Beginner/Intermediate
Linux VMs Tutorial 01, 02 Beginner/Intermediate
Remote Fetch Tutorial 02 Intermediate
DR Testing Tutorial 03 Advanced
Database Migration Tutorial 03 Advanced
Production Deployment Tutorial 04 Enterprise
Kubernetes/OpenShift Tutorial 04 Enterprise

By Use Case

Use Case Recommended Tutorial
Migrate a single VM Tutorial 01
Migrate 10-50 VMs Tutorial 02
Migrate 100+ VMs Tutorial 04
Test DR environment Tutorial 03
Move database server Tutorial 03
Production migration Tutorial 04
Learn the tool Tutorial 01 → 02 → 03
Quick proof of concept Tutorial 01

Tutorial Structure

Each tutorial follows this structure:

1. Overview

2. Concepts

3. Hands-On Practice

4. Validation

5. Summary

Tutorial Prerequisites

For All Tutorials

Required:

Optional:

Tutorial-Specific Prerequisites

Tutorial 01 (Beginner):

Tutorial 02 (Intermediate):

Tutorial 03 (Advanced):

Tutorial 04 (Enterprise):

Practice Environment Setup

Option 1: Local Practice

# Install Hyper2KVM
pip install "hyper2kvm[full]"

# Install libvirt for testing
sudo dnf install -y libvirt qemu-kvm virt-manager  # Fedora/RHEL
sudo apt-get install -y libvirt-daemon qemu-kvm  # Ubuntu

# Download sample VMs (if needed)
# See examples/test-vms/ for sample VMDK files

Option 2: Lab Environment

Consider setting up a dedicated lab with:

Option 3: Cloud-Based Practice

Use cloud providers for practice:

Note: Some tutorials include cloud-specific examples.

Getting Help

During Tutorials

If you get stuck:

  1. Check the Troubleshooting section in the tutorial
  2. Review error messages carefully
  3. Consult the troubleshooting guide: Troubleshooting Guide
  4. Check migration recipes: Migration Recipes
  5. Ask for help: GitHub Discussions

Additional Resources

Time Estimates

Total Learning Time

Path Time Description
Quick Start 2 hours Tutorial 01 only
Intermediate 12 hours Tutorials 01-02
Advanced 24+ hours Tutorials 01-03
Complete 40+ hours All tutorials + practice
Enterprise Ready 80+ hours All tutorials + production deployment

Practice Recommendations

Tutorial Goals

After Tutorial 01 (Beginner)

✅ Understand basic migration concepts
✅ Perform a simple VM migration
✅ Import VM to libvirt
✅ Verify migrated VM boots

After Tutorial 02 (Intermediate)

✅ Perform batch migrations
✅ Use different input formats
✅ Fetch VMs remotely
✅ Automate migration workflows
✅ Validate and rollback migrations

After Tutorial 03 (Advanced)

✅ Perform live migrations
✅ Migrate database servers safely
✅ Test DR scenarios
✅ Create custom fixers
✅ Optimize performance
✅ Troubleshoot complex issues

After Tutorial 04 (Enterprise)

✅ Design production architecture
✅ Implement HA and monitoring
✅ Deploy on Kubernetes/OpenShift
✅ Meet security requirements
✅ Plan large-scale migrations
✅ Ensure compliance

Before Tutorials

During Tutorials

After Tutorials

Feedback and Improvements

Help us improve these tutorials:

What’s Next?

Choose your starting point:

🎯 I’m brand new to Hyper2KVM

→ Start with Tutorial 01 - Beginner

🚀 I’ve done a basic migration before

→ Jump to Tutorial 02 - Intermediate

🔧 I need advanced features

→ Go to Tutorial 03 - Advanced

🏢 I’m planning production deployment

→ See Tutorial 04 - Enterprise

📚 I want to explore features

→ Check Features Index

Ready to learn? Start with Tutorial 01 →

Last Updated: February 2026 Total Tutorials: 4 Estimated Total Time: 40+ hours for complete mastery

This site is open source. Improve this page.