SysTutorials

Mount Xen DomU Disk Images with kpartx on Linux

· updated April 12, 2026

When you need to access files from a Xen guest’s disk image without booting the VM, you can attach and mount its partitions directly on the host using kpartx. This is useful for recovery, forensics, backup verification, or migrating data between systems.

Using kpartx to expose partitions

The kpartx utility creates device mappings for partitions within a disk image file. Given a raw disk image file (typically named something like vmdisk0 or domU.img), activate all partitions with:

kpartx -av ./vmdisk0

This creates loop device mappings and outputs something like:

add map loop1p1 (253:8): 0 497664 linear /dev/loop1 2048
add map loop1p2 (253:9): 0 2 linear /dev/loop1 501758
add map loop1p5 (253:10): 0 63557632 linear /dev/loop1 501760
add map loop1p6 (253:11): 0 61769665 linear /dev/loop1 64059455

The mapped partitions appear as device files in /dev/mapper/ (e.g., loop1p1, loop1p2). You can now treat them like regular block devices.

Mounting filesystems

Mount individual partitions normally:

mkdir -p /mnt/guest-root
mount /dev/mapper/loop1p1 /mnt/guest-root

For ext4, btrfs, or other filesystems, mount auto-detects the type. If you need to specify a type explicitly:

mount -t ext4 /dev/mapper/loop1p1 /mnt/guest-root
mount -t xfs /dev/mapper/loop1p5 /mnt/guest-root/data

Handling LVM volumes

If the guest uses LVM, the physical volumes within the disk image may be automatically detected and activated. List available volume groups:

vgs

Output example:

VG      #PV #LV #SN Attr   VSize   VFree 
HomeLVM   1   1   0 wz--n- 683.59g     0 
vg0       2   2   0 wz--n-  59.75g 29.49g

Mount the LVM logical volumes like any other block device:

mount /dev/vg0/root /mnt/guest-root
mount /dev/vg0/home /mnt/guest-root/home

Cleanup

Always unmount all filesystems before removing the device mappings:

umount /mnt/guest-root
umount /mnt/guest-root/home

If the guest uses LVM, deactivate the volume groups first:

vgchange -an vg0

Then remove the kpartx mappings:

kpartx -dv ./vmdisk0

This cleans up all the loop device mappings and frees associated resources.

Troubleshooting

If kpartx fails with “No loop devices available,” ensure the loop module is loaded:

modprobe loop

For qcow2 or other non-raw image formats, first convert or mount with qemu-nbd:

qemu-nbd -c /dev/nbd0 guest.qcow2
kpartx -av /dev/nbd0

Don’t forget to disconnect the NBD device when done:

qemu-nbd -d /dev/nbd0

These related commands are often used alongside the tools discussed in this article:

Quick Reference

This article covered the essential concepts and commands for the topic. For more information, consult the official documentation or manual pages. The key takeaway is to understand the fundamentals before applying advanced configurations.

Practice in a test environment before making changes on production systems. Keep notes of what works and what does not for future reference.

2026 Comprehensive Guide: Best Practices

This extended guide covers Mount Xen DomU Disk Images with kpartx on Linux with advanced techniques and troubleshooting tips for 2026. Following modern best practices ensures reliable, maintainable, and secure systems.

Advanced Implementation Strategies

For complex deployments, consider these approaches: Infrastructure as Code for reproducible environments, container-based isolation for dependency management, and CI/CD pipelines for automated testing and deployment. Always document your custom configurations and maintain separate development, staging, and production environments.

Security and Hardening

Security is foundational to all system administration. Implement layered defense: network segmentation, host-based firewalls, intrusion detection, and regular security audits. Use SSH key-based authentication instead of passwords. Encrypt sensitive data at rest and in transit. Follow the principle of least privilege for access controls.

Performance Optimization

Troubleshooting Methodology

Follow a systematic approach to debugging: reproduce the issue, isolate variables, check logs, test fixes. Keep detailed logs and document solutions found. For intermittent issues, add monitoring and alerting. Use verbose modes and debug flags when needed.

These tools complement the techniques covered in this article:

Integration with Modern Workflows

Modern operations emphasize automation, observability, and version control. Use orchestration tools like Ansible, Terraform, or Kubernetes for infrastructure. Implement centralized logging and metrics. Maintain comprehensive documentation for all systems and processes.

Quick Reference Summary

This comprehensive guide provides extended knowledge for Mount Xen DomU Disk Images with kpartx on Linux. For specialized requirements, refer to official documentation. Practice in test environments before production deployment. Keep backups of critical configurations and data.

← All posts